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RISC USER SURVEY 


We were more than pleased at the response to our Reader Survey included with the April 
issue of RISC User (Volume 2 Issue 7). Not only did over 500 members take the time and 
trouble to reply, but many included additional and constructive comments as part of their 


response, and several readers even wrote separate letters with further comments and 
suggestions. 


Yl 


We have now completed a preliminary analysis of the responses, and are already using the 
information obtained in planning this and future issues of RISC User. For example, a majority 
of readers were positively in favour of reducing the number of long listings in the magazine, 
which supports the moves in this direction which we had already begun to make. 


Another interesting snippet from the statistics is that over 70% of readers claim to have 
purchased some item as a result of an advert in RISC User, indicating both the dedication to 
the Archimedes of our readership, and the value of the advertising to our readers. 


We should have completed our analysis in time for the October issue. 


RISC OS IS THE ARCHIMEDES 


Now that the RISC OS upgrade is available from stock (and at the time of writing still at the 
special low price of £33.35 inc. VAT (plus postage - category D, see Retail Catalogue) we will 
in future concentrate solely on RISC OS when it comes to writing, editing and checking 
programs for RISC User. RISC OS is THE Archimedes operating system, and turns the 
machine into the sophisticated but easy-to-use system we all hoped it would be. 


NEW BEEBUG PRODUCTS FOR THE ARC 

You may already be aware that BEEBUG has been developing a number of new products for 
the Archimedes. First to be available are Hard Disc Utilities providing sophisticated backup, 
archiving (file compression) and file finder for approximately £35 to members, and Scavenger, 
a scanner system for the Archimedes which will offer a resolution of 400 dots per inch at prices 
from just under £200. Full details of both products are in the Retail Catalogue. 


A KS VALKAYNAAN 
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A3000 ON SPECIAL OFFER TO TEACHERS 


Acorn has announced a joint scheme with selected Acorn dealers (including BEEBUG) to offer 
the A3000 at a reduced price to teachers. Full details are available from BEEBUG. 
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A3000 SUCCESS AT SHOW 


The new Acorn A3000 proved a major success at 
the recent BBC Acorn User Show. It was the first 
opportunity for members of the public to purchase the 
new machine, and to cope with the expected demand, 
Acorn provided a large lorry full of A3000s. In the 
event, the demand outstripped even Acorn’s most 
optimistic predictions, and after the three days of the 
show only a handful of machines remained. This 
success was probably partly due to the special 
arrangement with Mercantile Credit, by which 
purchasers could buy the system with 0% finance over 
12 months, this being arranged on the spot. As a 
further incentive, Acorn was giving away a free 
carrying case and monitor stand with each A3000, and 
BEEBUG was supplementing this with an additional 
package of free items worth nearly £100. 


ARMADEUS 

Armadeus is a new package from Clares, which 
despite the corny name isn't in fact a music program. 
Rather, it is a sound sampler system which is designed to 
work with either Clares' new sound sampler podule, or 
with a number of existing podules such as those from 
Armadillo and Wild Vision. Armadeus allows sampled 
images to be edited, and pseudo-stereo and echo added. 
The sampled waveform can be displayed on screen as a 
graph, and can be edited to make changes to the sound. 
It is also possible to connect a keyboard via a MIDI 
podule to allow playback of the sampled sounds, and to 
read tunes from Atari format discs. Armadeus costs 
£79.95 (inc. VAT), and includes two discs of sampled 
sound. 


To complement Armadeus, Clares have produced a 
sound sampler podule. This features line and 
microphone inputs, and has software selectable gain to 
ensure the correct level is chosen while sampling. Also 
provided on the podule is a sound output offering 
superior quality compared to the Archimedes’ 
headphone socket. The Clares’ sound sampler costs 
£149.95 (inc. VAT). More details are available from 
Clares Micro Supplies, 98 Middlewich Road, Northwich, 
Cheshire, tel. (0606) 48511. 
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COLOUR DIGITISING 


Wild Vision, a company known for its graphics 
hardware, has announced a real time colour video 
digitiser for the Archimedes. Unlike other such 
products, the Hawk V9, as the new system is called, 
can capture an image in the space of a single frame. 
This means that moving images can be taken directly 
from a video camera without the need for a video 
recorder with a high quality freeze frame facility. The 
image is read directly into the Archimedes memory, at a 
resolution of 256 by 512. The supplied software 
subsequently allows this to be displayed in any 256- 
colour mode, and sections of the image can be saved 
as sprites for incorporating into other packages. The 
Hawk V9 should be available by the autumn, and will 
sell for under £500. For more details, contact Wild 
Vision, 6 Jesmond Road, Newcastle Upon Tyne NE2 4PQ, 
tel. 091-281 8481. 


LET ME TELL YOU A STORY 


Presenter-Story is a new Desktop Presentation 
system from Lingenuity. For those who are unfamiliar 
with the term, Desktop presentation is the name given 
to the process of producing fancy text and graphics 
screens to form a display sequence. A typical example 
would be a rolling demo running in a shop window. The 
presentation sequence is built up from a number of 
pre-created frames, and these can consist of either text 
or graphics. Text can be in any fancy font, and in a 
number of styles and colours. Graphics can consist of 
displays such as histograms and barcharts, as well as 
logos which can be designed using a built-in editor, 
The display sequence is specified using a script 
language, and the method of moving from one frame to 
another is programmable. User input can alter the flow 
of the sequence, and hard copy of frames can be obtained 
via the RISC OS printer drivers. Presenter-Story costs 
£229.94 (inc. VAT). 


Also new from Lingenuity is Presenter Il, a revised 
version of the company’s existing package. Despite the 
similar names, this package performs a different 
function to Presenter-Story, and allows imported data to 
be displayed in various graph formats, including three 
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dimensional forms. The numeric data can be imported 
from a number of sources, including standard comma 
separated value format. Presenter II is fully multi- 
tasking under the RISC OS Desktop, and completed 
graphs can be printed out using the RISC OS printer 
drivers. Presenter Il costs £57.44 (inc. VAT). For more 
details of both products, contact Lingenuity, Wood 
Farm, Linstead Magna, Halesworth, Suffolk IP19 ODU, 
tel. (0986) 85477. 


SCSI SYSTEMS 


The latest craze in Archimedes hardware appears to 
be SCSI (Small Computer Systems Interface) hard disc 
drives. Two companies, Oak Computers and Lingenuity, 
both launched packages at the BBC Acorn User Show. 
While SCSI is a general purpose interface for connecting 
peripherals and storage devices, both companies were 
using the system to connect high-capacity hard discs to 
the Archimedes. 


The Lingenuity system consists of a half width SCSI 
interface podule which costs £228.85 (inc. VAT), or 
£573.85 (inc. VAT) with a 45Mbyte internal hard disc 
drive. Lingenuity also do a version for the A3000, costing 
£171.35 (inc. VAT) for the internal expansion board, or 
£516.35 (inc. VAT) with a 20Mbyte external drive. The 
Oak system uses a similar interface card, but they offer a 
wider choice of drives, from a 20Mbyte internal unit at 
£431.25 (inc. VAT) to a 330Mbyte external device for 
£2760 (inc. VAT). Both systems include an ADFS-like 
filing system which will control not only hard discs, but 
also other SCSI devices such as tape streamers. 


More details can be obtained from Lingenuity at the 
address given below, and from Oak Computers, Cross 
Park House, Low Green, Rawdon, Leeds LS19 6HA, 
tel. (0532) 502615. 


MEWSOFT PRODUCTS 

Mewsoft has upgraded its product line to include full 
Archimedes versions of its products. The three titles, the 
Fax"File Manager, the Forms Manager and the Fancy 
Labeller were previously available in versions that worked 
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on both the model B and the Archimedes. The first of 
these programs is designed to generate printed pages 
suitable for incorporating into personal organisers, and 
includes a 480 entry address book and diary. The other 
two packages allow forms and labels to be designed to 
your particular requirements. Mewsoft claim that the 
new versions make full use of the power of the 
Archimedes. The packages cost £27.90 (inc. VAT) 
each, and are available from Mewsoft, 11 Cressy Road, 
London NW3 2NB, tel. 01-267 2642. 


STUDYING 1ST WORD PLUS 


Norfolk Educational Press has produced a study 
guide for the 1st Word Plus word processor, as part 
of the government's TVEI program. The fourteen 
page guide is split into thirteen separate exercises, 
each covering a different feature of 1st Word Plus. 
The guide is presented in a style which is designed 
to let relative newcomers to word processing pick 
up details of all the available features very quickly. 
The cost of the guide is £15.00, which includes a 
disc featuring the sample text used throughout the 
book. For educational users, a considerable 
discount is available on multiple copies. For more 
details, contact The TVEI Unit, The County INSET 
Centre, Witard Road, Norwich, Norfolk NR7 9XD, 
tel. (0603) 33276. 


MICRONET TAKEOVER 

The Telemap Group, who run the Micronet computer 
magazine on Prestel has been bought out by British 
Telecom, who previously owned a 40% stake in the 
company. Commenting on the takeover, John Tomany, 
managing director of the Telemap Group, said that it was 
a logical move. He added that business is as usual, but 
that the closer integration with British Telecom itself will 
allow future improvements in the services provided by 
Micronet. 


Meanwhile, the Telemap Group has moved from 
their London office to new premises at Dialcom House, 
Brindley Way, Hemel Hempstead, Herts HP3 9RR, 
tel. (0442) 237788. All Micronet correspondence should 
be sent to this new address. 
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PipeDream 3 breaks down the barriers between word processor, spreadsheet and database. You can 
include numerical tables in your letters and reports, add paragraphs to your spreadsheets, and perform 
calculations within your databases. 


Based on PipeDream 2, the best-selling integrated package for the Archimedes, PipeDream 3 has been 
completely re-written to take full advantage of RISC OS - if you can use RISC OS, you can use PipeDream 
3. Itis fully multi-tasking and multi-windowing, so youcan work on many documentsat once and instantly 
move information between them. And since PipeDream 3 can automatically load and save most popular 
file formats, including VIEW and First Word Plus, switching to it from other programs has never been 
easier. 


Power, flexibility, speed, ease of use. PipeDream 3. Breaking down the barriers. 
For a free brochure, see your Archimedes dealer, or phone us on 0954 211472 or return the coupon. 
PipeDream 3 is for all Archimedes computers with RISC OS and IMbyte of RAM, 
PipeDream 3 costs £147.00 +VAT. 


Major features include: 


many documents loaded at once automatic loading of VIEW, 

intuitive RISC OS user interface ViewSheet, Lotus, First Word For a free brochure, complete and retum this coupon 

displaying and printing Plus, Tab and CSV files | pipeDream 3.0 View Professional [) I 

of pictures within text automatic saving of VIEW, Name | 

built-in 93,003 word Lotus, Acorn DTP format, Tab {Address | 

spelling checker and CSV files 

file compatibility with multi-field sorting an aS — a er | 
| 
| 
| 


PC & Z88 PipeDream and use of all available fonts | Post code 
BBC View Professional 62 spreadsheet functions 
background recalculation external references for 3-D | Colton Software, Broadway House, 149-151 St. Neots 


keystroke compatibility modelling | Road, Hardwick, Cambridge CB3 7QJ, England. 


with Z38 & PC PipeDream macro file recorder 
788 filing system * slot protection 


Fax: 0954 211607 Tel: 0954 211472 
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Colton Software, Broadway House, 149-151 St. Neots Road, Hardwick, Cambridge, CB3 7Q], England. 
Fax. 0954 211607 Tel, 0954 211472 
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ACORN DESKTOP PUBLISHER 


Reviewed by Mike Williams 


In our recent reader survey, desktop 
publishing (known as DTP) was cited by many 
readers as an application in which they were 
interested and intended to buy a suitable 
package. As you may know, many software 
houses, including BEEBUG, have been 
developing DTP packages, but it is Acorn who 
are first in the field. Is this going to be the 
definitive DTP package for the Archimedes, or 
would you do better to wait? | hope to give you 
some guidance on answering that question in 
the course of this review. Here at BEEBUG, 
we have been using DTP (though on an Apple 
Macintosh) to originate both BEEBUG and 
RISC User for over two years now. 


Test document as described in text 


For those who are not really sure what 
DTP is all about, a brief introduction. DTP is 
concerned with the design and layout of both 
text and graphics on the page for printing. It 
usually gives considerable control over the 
appearance of text, including choice of font 
and size, less so with regard to graphics. 
Most DTP packages include some word 
processing capability and some rudimentary 
drawing tools, and there is obviously an 
overlap here with other applications. 


In one respect, it is not surprising that 
Acorn’s DTP package has appeared first. It 
is not completely new, but a rewrite of 
Timeworks Desktop Publisher for the Atari 
ST and PC market, where it has achieved 
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some success as a low cost DTP package. 
Desktop Publisher for the Archimedes is 
produced as an Acorn product, in the same 
way as 1st Word Plus, by GST. 


The packaging is quite lavish, a very 
smart slip-in box and library case containing 
three discs, a relatively slim 140 page 
manual, and the inevitable keystrip. The 
three discs comprise a programs disc, a 
work disc, and an examples disc. In 
reviewing Acorn Desktop Publisher | propose 
first to describe its main features in order to 
give some indication of what it can do, and to 
try and convey something of its flavour. | will 
then consider some major issues of 
importance to anyone contemplating 
purchase, before giving my conclusions. 


USING ACORN DTP 

Like all good RISC OS software, Acorn 
DTP is installed as an application on the icon 
bar. Double clicking on this opens a window 
which will contain the page you are working 
on, and a second window which allows the 
choice of one of four tools: Frame, Text, 
Paragraph, and Graphics. All functions within 
Acorn DTP fall into one of these four 
categories or modes. 


All pages have a default format, a master 
page and may use one or more style sheets. 
The page format determines the size of paper 
you are working with (A4 etc), its orientation 
(portrait or landscape), and whether left- and 
right-hand pages are to the same format. 
Note that the page format can only be altered 
before you start work on a document, 
otherwise the default (A4 size) is used. 


All text and graphics is laid out within 
frames. The master page allows you to set a 
standard which will be used by all pages in a 
particular document, for example number, size 
and position of columns. You can also establish 
separate masters for left- and right-hand pages. 


Style sheets are used to determine the 
style of a paragraph, including choice of 
point size (the way in which character size is 
measured), font (e.g. Courier, Helvetica etc.), 
and style (bold, italic, underline etc.). Style 
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DESKTOP 


DIARY 


by Mike lronmonger 


This article, with part two to follow next month, 
describes a useful diary facility to add to your 
Desktop, and is fully RISC OS compatible. The 
program runs from an application directory, and 
uses all the standard Desktop features. When 
installed, the diary icon appears on the menu bar. 


ACORN 
DESKTOP 
PUBLISHER 


file for subsequent reloa- 
ding, though you can 
create as many separate 
diary files as you wish. 
Saving and loading fol- 
lows RISC OS stan- 
dards. To load a diary 
file, double click on its 
icon, or drag it on to the 
Diary icon on the menu 
bar (once installed). If a file is loaded which has an 
entry for the current date then a window will 
automatically be opened showing that entry. Drag- 
ging a diary file into the calendar window or an entry 
window will merge the entries in that file with those 
already loaded and present, overwriting existing _ 


Part of test document output on a laser printer 


sheets also control justification, tab settings, 
hyphenation, spacing algorithms and leading 
(pronounced ‘ledding’ - the spacing between 
lines). Four style sheets are provided as 
standard; you can modify these as well as 
designing your own. The style sheet called 
body text is used as the default. However, 
choice of font, point size and style can also 
be controlled independently of style sheets. 


| created a document to test the package 
after working through the tutorial sections of the 
manual. The first step was to set up the two 
column format that | required on the master 
page, and | decided to position a box centrally 
at the top containing a title ‘white-out’ on a dark 
grey background, and using a so-called drop- 
shadow frame. The frame tool allows you to 
create boxes, and to give a box one of four 
styles of border (three sizes of single line, one 
double line). To create a drop-shadow box, | 
had to create two frames, specifying that the 
border on one was to appear only at the right 
and at the bottom, and then positioning the two 
boxes one over the other. You can decide 
which box appears in front (or even make them 
transparent). | also selected a dark grey tint as 
the background for the box. | then entered the 
text for my title from the keyboard, put this in 
white, and created a new style sheet to get the 
appearance | wanted (see illustration) using the 
paragraph tool. 
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| then transferred an ASCII text file (one 
of the other articles in this issue of RISC 
User) into my document. This is a two stage 
process accomplished in frame mode, first 
accessing the text itself as it is necessary to 
fill each frame (in this case column) in turn. A 
dashed line at the foot of a box indicates that 
more of the story still remains to be 
positioned. Unfortunately, if the box has a 
frame this indicator is invisible! Acorn DTP 
will accept any ASCII text file, and files from 
Edit or 1st Word Plus including any style 
information already included at that stage. 


In my trial document | tried to level up the 
last two columns to finish about halfway down 
the page, but this proved impossible. Fine 
adjustments like this can usually be made by 
adjusting the leading by fractions of a point 
(itself 1/72 of an inch). Acorn DTP will only allow 
leading to be specified to a whole number of 
points; the same is true of font size, quite a 
limitation when fine adjustments are needed. 


Another small touch which | found difficult 
to achieve was to align the first lines of text 
in each column to appear under my central 
title box. Spacing can be controlled by 
placing frames around frames, but precise 
alignment could not be achieved, again not 
very professional. The title to the article was 
styled and positioned, but | could not make it 
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move to the very top of the page, even when 
the top margin space in the relevant style 
sheet was set to zero. Recourse to the 
manual was little help on these points, but it 
appears that frames include a fixed amount 
of white space both inside and outside the 
frame to separate them from any text. 


Creating a frame border 


The text tool is used to enter text directly 
from the keyboard, and to edit it. There is a 
find (and replace) function, and the facility to 
cut (or copy) text to the clipboard, and to paste 
into the document text from the clipboard - you 
can also do this with frames including their 
contents. Text editing also controls kerning 
(the facility to alter the spacing between pairs 
of characters), and the use of a soft hyphen 
and a fixed space. | found that what editing | 
required was straightforward to achieve. 


The final tool is for graphics or pictures. 
Acorn DTP can import two types of picture, 
image such as Paint might produce (in other 
words a sprite), and /ine art such as can be 
produced with Draw. Pictures of either type 
are loaded and positioned in boxes as with 
stories. Pictures can be rescaled or cropped, 
and the examples disc contains a good 
selection of both types. The graphics tool also 
allows a small number of lines and curves to 
be created within Acorn DTP (lines suitable 
for simple tables or diagrams, for example). 


The printing of documents uses an 
improved set of the printer drivers supplied on 
the Applications disc, covering Epson dot 
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matrix and compatible printers, Postscript 
printers, the Integrex 132 colour printer, and 
HP Laserjet and compatibles. Acorn 
recommends you replace your existing printer 
drivers with these latest versions for all printing. 


MAJOR CONSIDERATIONS 

Although Acorn DTP will run on a 1MByte 
machine (i.e. a 310 or 410) you need to give 
careful consideration to the choice of a 
suitable system. First of all, the software 
makes frequent reference to a ‘work disc’. 
Using a floppy, you will spend most of your 
time (literally) waiting for the screen display to 
be refreshed. Performance can be improved 
quite a lot by allocating adequate font cache 
(as Acorn recommend), and speed is then 
acceptable for occasional use, but | consider 
a hard disc (see this month’s review) to be 
essential for anyone intending to make 
regular substantial use of Acorn DTP. 


Using the graphics tool with line and 
image art 


| ran Acorn DTP on a 310 with 1MByte of 
memory. | found that provided | restricted 
myself to text only (no pictures), memory 
appeared to be sufficient. Incorporating pictures 
onto the page was also trouble-free at first, but 
any attempt to resize or crop a picture was 
unsuccessful because of insufficient memory. 
At least Acorn DTP coped without collapsing 
completely, but if you want to incorporate many 
pictures into your documents (particularly 
sprites) then | suggest that 2MBytes of memory 
are the minimum, and that means a 420, 440 or 
an A3000 upgraded to 2MBytes. 
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It also helps on a 1MByte machine to 
carry out all the editing without a printer 
driver installed, to save memory, using the 
printer driver only when printout is actually 
required. Again, with 2MBytes or more this 
constraint would disappear. In fact, system 
tuning is quite important to get the best 
performance from a product such as Acorn 
DTP, but to their credit, Acorn has provided 
detailed information on this. 


There are also factors about Acorn DTP 
itself which you should be aware of. | have 
already mentioned the restriction to integer 
point sizes, which is much too large for the 
detailed adjustment needed for a really 
professional design. There are at present only 
five fonts available (one sans serif, three serif 
and one, usefully, of symbols), though using 
Acorn’s new outline fonts for improved 
appearance. Only four styles of border can be 
added to a frame, and there is no frame editor. 
In addition you cannot control the amount of 
space separating a frame from the text inside or 
outside. There are separate clipboards for 
frames, text etc. but you cannot check what is 
on any clipboard. Style sheets only apply to 
paragraphs, not to selected blocks of text, so 
changing style through a document can involve 
changing the style sheet for each individual 
paragraph. Other limitations may also exist. 


Menus use the standard approach of 
showing in bold options which are available, 
and in grey those which aren't. However, the 
main menu always shows all options in bold 
regardiess of which tool or mode is current. 
You can, for example, select text from the 
main menu, only to find that in the text menu 
no options are available because you are not 
in text mode. To change mode means that 
Acorn DTP has to remove all menus and re- 
display the view of the current page. | know 
this conforms with Acorn's own guidelines, 
but it is frustrating nevertheless. 


In fact, the degree to which Acorn DTP 
reconstructs the view of the current page is 
excessive. For example, using find & replace to 
search for a word which appeared twice in the 
text visible on the screen resulted in Acorn 
DTP refreshing the entire screen display on 
both occasions, although the only changes 
were to display the first occurrence of the word, 
and then the second, in inverse video. | cannot 
believe that it has to be as bad as it appears, 
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though it may derive from the parentage of 
Acorn DTP on rather more primitive systems. 
However, this is only apparent when using a 
floppy-based system; with a hard disc all 
screen refreshes are commendably quick. 


Lastly, | encountered two actual bugs. 
Highlighting one title line in order to change 
point size resulted in further characters of the 
next line becoming highlighted, such that any 
further changes of style applied to these too. 
This was consistently reproducible. On one 
occasion, loading a picture file from the 
supplied examples disc resulted in 
meaningless error messages and a completely 
hung machine from which the only escape was 
to press Ctri-Break, causing the complete loss 
of all changes made to my current document 
since the time when it was last saved. Acorn 
says the latter can arise in any situation where 
your machine is working at its limits, and that it 
is not anything within DTP itself. 


DOCUMENTATION 

This is well written and produced, but the 
tutorial section is too short to give you real 
confidence in using the software, yet | feel 
that the reference section is too brief and 
lacking in really detailed information which 
might compensate. A package on this scale 
surely demands better coverage. 


CONCLUSIONS 

To what extent the limitations of Acorn DTP 
reflect those in the original PC version | do not 
know. You will just have to decide whether 
what is offered is adequate for your needs. My 
view at this time, is that you should not rush 
into buying Acorn Desktop Publisher, costing 
as it does a substantial £170 plus, until you 
have been able to examine some of the other 
offerings which will be appearing soon. You 
might also be interested to learn that 
Timeworks for the PC market costs under £90! 


Supplier 


Acorn Computers 

Cambridge Technopark 

645 Newmarket Road, 

Cambridge CB5 8PD, 

Tel. (0223) 241144 

£171.35 inc. VAT 

(£162.78 to RISC User members 
direct from BEEBUG - add £3 for p&p.) 
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This short program by S.S.Pardesi illustrates the power of the Archimedes when 
applied to the technique of inbetweening. 


Jabetmesning 


i! you are unfamiliar with the term 
inbetweening, you will probably have seen the 
effect as it is used not infrequently on television 
in title sequences and the like. In essence, 
inbetweening involves defining two shapes, and 
then generating a series of intermediate shapes 
so that one object appears to be transformed 
step by step into the other. Visually it is often only 
quite near the end of the process that the new 
shape reveals itself meaningfully to the watcher. 


Of course, the larger the number of steps taken, 
and the smaller the change from one position to the 
next, the smoother and more impressive the 
transformation appears. That's where the power of 
the Archimedes comes in. 


The program listed here is really only a 
demonstration of the technique using wire-frame 
shapes, and can be developed considerably if 
required, Type the program in and save it away. 
When run, it asks you to define the first shape 
using the mouse. Move the pointer to a suitable 
starting position and press Select. Now continue to 
move the pointer, pressing Select at each corner, 
until you reach the last point you want to include in 
your definition, when you should press Adjust. 


Once you have completed the first shape, you 
will be asked to define the second. The second 
shape MUST have the same number of defined 
points as the first. For this reason, there is no need 
to press Adjust rather than Select on the last point, 
as the program will have been counting the number 
of points entered. 


Once both shapes have been defined, the 
program immediately commences transforming 
from one to the other, and then back again, 
repeating the whole process indefinitely. Pressing 
any mouse button during this time will return you 
to the starting point of the program ready to 
define two new shapes. Pressing Escape will exit 
from the program altogether. 


If you define both shapes in the same position 
on the screen then one object gradually turns into 
the other. If you define one shape to the left of the 
screen, and the other to the right then you will see 
the object moving across the screen as the 
changes occur. If you find you need fewer points in 
one shape than the other, then several points can 
all be defined in the same position and will appear 
as a single point on the screen. 


In the program, the arrays are dimensioned 
sufficient for 100 points, and 100 steps are used in 
transforming from one to the other. Both values are 
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set near the start of the program, and may be 
changed as required. The speed of transformation is 
artificially slowed down by the procedure PROCwait. 
Change the parameter used (smaller numbers mean 
faster speed), or the definition itself if you wish. 


Our illustration shows a Christmas tree being 
transformed into a castle, but we are sure you will 
be able to find many more ingenious applications. 


10 REM >Morph 
20 REM Program Inbetweening 
30 REM Version A 1.02 
40 REM Author §.S.Pardesi 


50 REM RISC User September 1989 
60 REM Program Subject to Copyright 


80 MODE 0:OFF 
90 ON ERROR MODE12:PRINT REPORTS;” at li 
ne “;ERL:END 

100 lim=100:sec=100 

110 DIM X1(lim,1),¥1 (Lim, 1),X2 (lim, 1), Y2( 
lim,1),SX(lim,1), SY (lim, 1) 

120 *POINTER 

130 MOUSE RECTANGLE 0,0,1279,800 

140 REPEAT 

150 CLS:pl=0:p2=0:f=0 

160 PRINT TAB(2,1);”This program allows y 
ou to draw two pictures, the computer will 
then animate” 

170 PRINT TAB(2,2);”one picture into the 
other. To begin drawing, press the Select b 
utton to plot” 

180 PRINT TAB(2,3);"the points‘of your pi 
cture, to end press the Adjust button.” 

190 PRINT TAB(10,5);"Number of points so 
far: “ 

200 REPEAT 
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210 PROCdraw (X1(),¥1(),p1) 450 FOR I=Il1 TO 12 STEP IS 
220 UNTIL bu=1 460 FOR J=J1 TO J2 STEP JS 
230 REM * DRAW SECOND SHAPE * 470 LINE X2(J,1)+(SX(J,1)*I) ,¥2(J,1)+(SY( 


240 exit=FALSE:CLS: f=0 
250 PRINT TAB(20,2);"Number of points in 


J,1)*1I) ,X2(J+1,1)+ (SX (J+1,1) #1), Y2(J+1,1)+( 
SY (J+1,1)*I) 


FIRST picture: “;pl 480 MOUSE xpos, ypos, bu 
260 PRINT TAB(20,4);”Number of points in 490 IF bu<>0 THEN J=JS+1:I=IS+1l:exit=TRUE 
SECOND picture: “ 500 NEXT J 
270 REPEAT 510 WAIT: PROCwait (0.3) :CLS 
280 PROCdraw(X2(),¥2(),p2) 520 NEXT I 
290 UNTIL p2=pl 530 ENDPROC 
300 REM * CALC STEP SIZES * 540 
310 FOR I=1 TO pl 550 DEF PROCdraw(X(),Y¥(),RETURN p) 
320 SX(I,1)=((X1(I,1) -X2(I,1))/sec) 560 MOUSE xpos, ypos,bu 
330 S¥(I,1)=((¥1(I,1)-¥2(I,1))/sec) 570 IF £=0 THEN MOVE xpos, ypos 
340 NEXT I 580 IF bu=4 OR bu=1 THEN 
350 REM * TRANSFORM SHAPES * 590 DRAW xpos, ypos 
360 exit=FALSE 600 p=p+l:f=1 
370 REPEAT 610 X(p,1)=xpos:Y (p,1)=ypos 
380 PROCtransform(1,sec-1,1,1,pl-1,1) 620 PROCwait (5) 
390 IF NOT exit PROCtransform(sec-1,1,-1, 630 PRINT TAB(36,5);p 
pl-1,1,-1) 640 ENDIF 
400 UNTIL exit 650 ENDPROC 
410 UNTIL FALSE 660 
420 END 670 DEF PROCwait (t) :endt=4*t 
430: 680 TIME=0:REPEAT: UNTIL TIME>endt 
440 DEF PROCtransform(I1,12,1S,J1,J2,JS) 690 ENDPROC RU 
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We offer full technical backup, service and advice as well as 
a comprehensive range of software and hardware 
for your Archimedes. If you have a problem - we can 
help you. 


Call in for a software or hardware demonstration, 
or phone for prices and availability 


Data Store 


6 Chatterton Road, Bromley, Kent 
Telephone : 01-460 8991 (closed Wednesdays) 
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Missing the diary feature from the Arthur Desktop? Mike lronmonger goes one 
better with a fully multi-tasking version for use under RISC OS. 


This article, with part two to follow next 
month, describes a useful diary facility to add 
to your RISC OS Desktop. The program runs 
from an application directory, and uses all 
the standard Desktop features. When 
installed, the diary icon appears on the menu 
bar. Clicking on this icon opens the diary 
window to display a calendar for a single 
month. Two arrows at the top allow you to 
move through the months in steps of a 
month (using Select), or a year (use Adjust). 


Whenever the current date is on display, 
this is highlighted by a black border, while 
any date for which an entry exists is 
highlighted with a grey background. Clicking 
the Menu button on the diary window opens 
up a menu with the following options: 


Go to the current date 

Save all entries 

Print entries for the currently displayed month 
Print entries for the currently displayed year 
Print all entries 


As with all Wimp menus, choosing an item 
from the menu with the Adjust button (rather 
than with Select) will leave the menu in place. 


Clicking on a date with an entry opens a 
window showing that entry, which can then 
be edited. Clicking on a date with no entry 
highlights the date and opens an empty 
window ready for some new text. The entry 
window allows four lines of 40 characters, 
with the name of the day and the date 
forming the window title. Up to 10 such 
windows may be open at any one time, for 
cross referencing entries for different dates. 


When editing an entry, the standard text 
caret is shown and this may be moved up, 
down, left or right with the cursor keys. 
Home takes you to the start of the first line 
while Return takes you to the start of the 
next line, unless you are already on the last 
line. The mouse pointer can also be used to 
position the text caret in the window. Text is 
entered from the keyboard as required, and 
Delete works as expected. Pressing the 
Menu button over an entry window displays 
a menu allowing you to clear all text (in the 
window), delete the entry completely 
(including the window), or print the entry. 
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All entries are saved to a single file for 
subsequent reloading, though you can create 
as many separate diary files as you wish. 
Saving and loading follows RISC OS 
standards. To load a diary file, double click on 
its icon, or drag it onto the Diary icon on the 
menu bar (once installed). If a file is loaded 
which has an entry for the current date then a 
window will automatically be opened showing 
that entry. However, dragging a diary file into 
the calendar window or an entry window, will 
merge the entries in that file with those 
already loaded and present, overwriting 
existing entries where necessary. 
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The Desktop Diary in action 


Diary files use the same file type as the 
old Arthur Desktop Diary, but the new diary 
files use a different and much more compact 
format. As a result, Arthur diary files cannot 
be loaded directly into the new diary 
application, but a conversion program, called 
Converter, is included on the magazine disc 
to perform just this task. When run, it asks for 
the name and year of the existing file, and a 
new name for the diary file. The old diary file 
is then loaded, converted to the new format, 
and then saved with the new name. 


SETTING UP THE APPLICATION 

You will need to create a directory called 
{Diary (just click on the drive icon, and then 
press Menu over the resulting directory 
viewer and choose the new directory option 
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from the menu) in which to save four files, 
!Boot and !Run (both Obey files), !Sprite (the 
sprite file) and !Runimage (the runnable 
program itself). Listing 1 is the boot file, and 
this should be created using Edit (press 
Menu on its icon on the icon bar and create 
a new Obey file). Save this as file !Boot in 
directory !Diary. Similarly, type in Listing 2 to 
create the Obey file !Run which should also 
be saved in your !Diary directory. 


Listing 1 

| !Boot file for Diary program 

| by Mike Ironmonger 

Set File$Type FEF Diary 

Set AliasS$@RunType FEF Run <Obey$Dir>.!Run %%*0 
IconSprites <Obey$Dir>. !Sprites 


Listing 2 

| !Run file for Diary program 

| by Mike Ironmonger 

Set FileSType FEF Diary 

Set Alias$@RunType FEF Run <Obey$Dir>.!Run $%*0 
IconSprites <Obey$Dir>. !Sprites 

WimpSlot -min 64K -max 64K 

Run <ObeySDir>.!RunImage %*0 


Listing 3 is a short program which you will 
need to run to create the !Sprite file. Before 
you do this you will need to load the font 
Trinity from Applications disc 1 (Apps1). The 
program SpriteMake creates two sprites 
(using the letter ‘D' from the Trinity font), one 
to represent the Diary program (in a directory 
viewer and on the icon bar), and a second 
for diary files. Unfortunately, there is no 
simple way in a magazine to create more 
complex sprites, but the magazine disc 
contains a !Sprite file with more elaborate 
icons. If you are typing in the program 
yourself, you may wish to use ArcPaint to 
create more detailed sprites of your own 
design. These should be called !Diary and 
file_fef, and designed in mode 12 with the 
Desktop palette to a size of 34 by 17 
graphics units. The !Sprite file on the 
magazine disc also contains equivalent small 
icons called smidiary and sm_fef. 


Listing 3 

10 REM > SpriteMake 

20 MODE12:GCOL 129:CLG 

30 SYS “Font_FindFont",, "Trinity .Medi 
um", 30*16,30*16 TO A% 

40 SYS "Font_FindFont",, "Trinity .Medi 
um", 24*16,24*16 TO Bt 
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50 SYS "Font_SetFontColours",A$%,1,2,5 
60 SYS "Font_Paint",,"D",16,12,8 
70 MOVE 0,0:MOVE 66,64:*SGET !diary 
80 GCOL128:CLG 
90 SYS "Font_SetFontColours",Bt,0,1,6 
100 SYS "Font_Paint",,"D",16,14,16 
110 GCOL7 
120 LINE 0,0,66,0:DRAW 66,64 
130 DRAW 0,64:DRAW 0,0 
140 MOVE 0,0:MOVE 66,64:*SGET file fef 
150 *SSAVE !Sprites 


The last listing is part one of the program 
proper, which should be typed in and saved 
in the !Diary directory with the name 
{Runimage. | suggest you also save a 
separate copy of this program under the 
name Split! to which part two can be 
appended next month. This month's program 
implements the calendar only, without the 
facility for making text entries. The additional 
code to provide these features will be added 
next month. Once all four files have been 
saved in the directory !Diary, double clicking 
on the !Diary icon from the Desktop will 
install the diary program as an application 
with its icon on the menu bar. Clicking on the 
menu bar icon will run the diary application 
as described above. 


Line 90 in the program is designed to 
assist in trapping any errors that may arise 
as a result of mis-typing the program listing. 
Once you are confident that all is working as 
it should be, change this line to read: 

90 ON ERROR PROCerror (ERR, REPORTS) 


Next month, in addition to the remaining 
code which adds the text entry and printing 
facilities, we will be providing some 
information about the workings of the Diary 
program itself. 


Listing 4 
10 REM >$.Splitl 
20 REM Program Desktop Diary 
30 REM Version A 2.51 
40 REM Author Mike Ironmonger 
50 REM RISC User September 1989 
60 REM Program Subject To Copyright 


80 PROCinitialise 
90 ON ERROR VDU4:PRINT REPORTS;" at 1 
ine ";ERL:END 
100 : 
110 REPEAT 
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120 SYS "Wimp _Poll",51,block% TO A% 

130 CASE A% OF 

140 WHEN 2 : SYS "Wimp OpenWindow",,b 
lock’ 

150 WHEN 3 
FALSE) 

160 WHEN 6 : PROCbutton_click(block$! 
8,block%!12,block%!16) 


: PROCclose_window(!block% 


190 WHEN 9 : PROCmenu_select (!block$%, 
block! 4) . 

200 WHEN 17,18 : PROCreceive (block$!1 
6) 

210 ENDCASE 


220 UNTIL quit’ 

230 SYS "Wimp CloseDown" 

240 END 

250 «+ 

260 DEFPROCclose_window (W%, del%) 

350 !blockt=W%:SYS "Wimp CloseWindow", 
+block% 

360 ENDPROC 

370 ss 

380 DEFPROCbutton_click (B%,W%, 1%) 

390 CASE B% OF 

400 WHEN 1 : PROCsa_click (12) 

410 WHEN 2 ; PROCmenu_click (W%, !block 
%,block%!4+12) 

420 WHEN 4 

440 ENDCASE 

450 ENDPROC 

460 : 

700 DEFPROCmenu_select (A%, B%) 

710 SYS "Wimp _GetPointerInfo",,block%: 
stayt=block%!8=1 

720 CASE mw% OF 

730 WHEN -2 : IF A%t=0 quit%=TRUE 

740 WHEN w_diary% : CASE A% OF 

750 WHEN 0 : PROCnew_month ((today%>> 
8) -month$) 

770 ENDCASE 

§30 ENDCASE 

840 IF stay% PROCmenu_click (mw%,mx%,my 


: PROCsa_click (1) 


850 ENDPROC 


870 DEFPROCreceive (M$) 
880 CASE M% OF 

890 WHEN 0 : quit%=TRUE 
920 ENDCASE 

930 ENDPROC 


950 DEFPROCsa_click (inc) 

960 CASE W% OF 

970 WHEN -2 : PROCnew_month (0) :PROCop 
en_window (w_diary%) 


RISC User September 1989 


990 WHEN w_diaryt : CASE I% OF 

1000 WHEN 0 ; PROCnew_month (~inc%) 

1010 WHEN 1 ; PROCnew_month (inc$) 

1030 ENDCASE 

1040 ENDCASE 

1050 ENDPROC 

1060 : 

1070 DEFPROCmenu_click (W%, X%, Y%) 

1080 mw%=W% :mx3=X%:my3=Y% 

1090 CASE W% OF 

1100 WHEN -2 : PROCmaster_menu("Diary" 
,"Quit,",X%,140) 

1110 WHEN w_diary% : PROCmaster_menu(" 
Diary","Goto today,Save notes,Print note 
s,",X%,¥%) 

1130 ENDCASE 

1140 ENDPROC 

1150 : 

1290 DEFPROCnew_month (inc%) 

1300 IF month$+inc%<0 ENDPROC 

1310 block%!0=w_diary%:FORI$=4T034:bloc 
k%!4=1%:SYS "Wimp DeleteIcon",,block%:NE 


1320 month$+=inct 

1330 mt=month$ MOD 12:y%=month% DIV 12 

1340 $month_buff%=month$ (m%)+" "+STRSy% 

1350 PROCset_icon_state(w_diary%, 3,0, 0) 

1360 Xt=8+FNday (yt,mt,1) *64:Yt=-152 

1370 FORD%=1TOnum_days% (m$)-(mt=1 AND F 
Nleap_year (y%) ) 

1380 E%t=(month%<<8) +D% 

1390 Bt=FNicon (w_diary%, STR$D%,X%,Y%, 44 
7 44,&27003009) 

1400 X%+=64:IF X%=456 X$=8:Y%-=48 

1410 NEXT 

1420 SYS "Wimp ForceRedraw",w_ diary, 8, 
-392,436,-108 

1430 Tt=FNtoday:IF T%<>today% todayt=T% 

1440 IF montht=(today%>>8) PROCset_icon 
_state(w_diary%, 3+today%AND255, 4,4) 

1450 ENDPROC 

1460 : 

2240 DEFFNleap year (Y%) 

2250 =(0=Y%MOD4 AND (Y%MOD100<>0 OR Y$M 
0D400=0) ) 

2260 DEFFNday (Y%,M%,D$%) 

2270 =(365*Y%+YtDIV4-YtDIV100+YSDIV400+ 
days_so_far%(M%)+(Mt<2 AND FNleap year (Y 
%) ) -2+D%) MOD7 

2980 DEFPROCset_icon_state(!block%,bloc 
k$!4,block%!8,block%!12) 

2990 SYS "Wimp SetIconState",,block% 

3000 ENDPROC 

3010 : 

3150 DEFFNtoday 
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All Lingenuity products are RISC OS compatible. 


NEW PRESENTER Il 


A RISC OS application based on the established presentation package for Archimedes users 
in schools and businesses alike. 3-D colour, Bar-, Line- and Pie-charts and graphs can be 
made quickly and easily in the RISC OS environment. These charts and graphs can be 
printed on any printer supported by RISC OS. As the files are Draw-compatible graph details 
can be altered within Draw allowing individual design. Added features include Stacked Bar 
charts, 3-D Pie with exploded segment, scattergram and line of best fit. 

£39.95 + VAT (upgrade from Presenter available at £14.95 + VAT). 


NEW SCSI INTERFACE 


Upgrade your Archimedes with a hard-drive using our Low-Cost fully functional SCS/ 
interface podule, Fast access time and use of industry standard data storage now gives 
Archimedes users unrivaled data storage capacity. Software to drive other SCS/ units will 
be available soon. 

£199.95 + VAT 300 & 400 series (A3000 version available at the BBC Acorn User Show). 


NEW PRESENTER STORY 


The ultimate in Business Presentation software. Turn your Archimedes into a tool to project 
combined images of Text, Logos, Graphs, Digitised & Video Pictures to illustrate your 
presentations more clearly. Many special screen features are included such as vertical and 
smooth scrolling and bouncing. It can be used with most makes of RGB projectors or you 
can use your Archimedes monitor for smaller Presentations. PRESENTER STORY is 
available for Business applications now. 

£199.00 + VAT 


NEW COLOUR ODIGITISER 


At last a real time colour digitiser for the Archimedes. Grab Video and other real time 
movement for inclusion in other RISC OS applications. Features include RISC OS 
Application software to allow the instant grabbing and dragging to DTP or Art packages. 
Available in the last quarter of this year but see it in action at the BBC Acorn User Show. 
Price: tha 


NEW COLOUR CONVERTER 


Do you want to capture colour images onto your Archimedes screen? The Colour Converter 
podule running with the Watford Digitiser allows full colour images to be captured and 
saved as screens or sprites. The package also includes new Dithering Software which will 
give you greatly enhanced near-television quality pictures, using an effective palette of 
256,000 colours! 

£169.95 + VAT 


VISA All Lingenuity products are available direct or from good Acorn dealers. 
and Educational discounts and site-licences are available. 


ACCESS For further details please contact us on 098 685 477 or write to 
accepted. Lingenuity, PO Box 10, Halesworth, Suffolk IP79 ODX. 
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3160 ?block%=1:SYS "OS Word", 14,block% 

3170 At=?block% : Y%=10* (A%>>4) + (ASAND15) 

3180 At=block%$?1:M%=22799+Y%*12+10* (A&> 
>4) + (A$AND15) 

3190 At=block%?2 

3200 =(M%<<8) +10* (A%>>4) + (ASAND15) 

3210 : 

3220 DEFPROCerror (!block%,$ (block%+4) } 

3230 SYS "Wimp ReportError",block%t,1,"D 
iary" 

3240 ENDPROC 

3250 : 

3260 DEFPROCinitialise 

3270 DIM blockt 90,menu% 400 

3290 DIM month$ (11), num_days% (11) 

3300 DIM days_so_far%(11),day$ (6) 

3310 month$ ()="January", "February", "Mar 
ch", "April", "May", "June", "July", "August" 
, "September", "October", "November", "Decem 
ber" 

3320 num_days$ ()=31, 28, 31,30, 31, 30,31,3 
1, 30,31, 30,31 

3330 days_so_far%()=0,31,59,90,120,151, 
181,212,243, 273, 304, 334 

3340 day$()="Monday", "Tuesday", "Wednesd 
ay", "Thursday", "Friday", "Saturday", "Sund 
ay" 

3350 : 

3360 todayt=FNtoday:montht=today%>>8 

3370 quit t=FALSE 

3380 : 

3390 SYS "Wimp Initialise", 200, &4B53415 
4,"Diary" 

3400 At=FNind_icon(-1,A%,1,7,"!diary",0 
79,58, 68,&3102) 

3410 w_diary%=FNcreate_ window ("Diary 

",A%,0,130,884, 444, 400,0,13,19) 

3420 At=FNicon(w_diary%,CHR$136, 8, -64,4 
4,52, &2700203D) 

3430 At=FNicon(w_diary%,CHR$137, 392,-64 
, 44,52, &2700203D) 

3440 At=FNind_icon(w_diary%,A%t,-1,28,"M 
on Tue Wed Thu Fri Sat Sun",0,-108,450,3 
6,&7000101) 

3450 At=FNind_icon(w_diary%,month_buff% 
771,15,"",102,-56, 240, 36,&7000109) 

3460 : 

3610 ENDPROC 

3620 : 

3630 DEFFNcreate window (title$,RETURN b 
uff%, lent, Xt, Y%, W%, Ht, bgt, hg%, F%) 

3640 $blockt=STRINGS (88, CHRS$0O) 

3650 !block%=X%:block%! 4=Y%-H% 

3660 block’! 8=xX%+W%:block%$!12=¥% 

3670 block$!28=F%:block%!32=&207 
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3680 block%$?35=bg%:block%!36=&103 

3690 block%?38=hg%:block$! 44=-H% 

3700 block$! 48=W%:block$!56=419 

3710 $ (block%+72) =titles 

3720 IF len%>0 DIM buff% len%:block%!56 
=6119:block%!72=buff%:block%!76=-1:block 
$!80=lLen% 

3730 SYS "Wimp _CreateWindow",,block% TO 
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3150 % 

3760 DEFPROCopen_window(!block%) 

3770 SYS "Wimp _GetWindowState", ,blockt 
3780 block%!28=-1:SYS "Wimp OpenWindow" 
>, block’ 

3730 ENDPROC 

3800 : 

3810 DEFFNicon(!blockt,text$,L%t,B%,Wt,H 
%,blockt! 20) 

3820 block%! 4=L%:block%! 8=B% 

3830 block$!12=Lt+W%:block%!16=Bt+H% 
3840 IF text$<>"" $ (block$+24) =text$ 
3850 SYS "Wimp CreateIcon",,block% TO I 
% 

3860 =I% 

3870 : 

3880 DEFFNind_icon(window%,RETURN buff% 
,block$!28,len%,text$,L%,B%t,W%t, Ht, F%) 
3890 IF buf£%<&8000 DIM buff£% len’ 

3900 block! 24=buff%:block%!32=len% 
3910 IF text$<>"" S$bufft=text$ 

3920 =FNicon (window%,"",L%,B%,W%,Ht,F%) 
3930 : 

3940 DEFPROCmaster_menu (title$,m$,X%, Y% 


3950 PROCcreate_menu(menut,title$,m$) 

3960 SYS "Wimp CreateMenu", ,menut, Xt-me 
nu$!16/2,Y% 

3970 ENDPROC 

3980 : 

3990 DEFPROCcreate_menu (Mt, title$,m$) 

4000 LOCAL I%,max% 

4010 $M%=title$:M%!12=&70207 

4020 M$!20=44:M%!24=0 

4030 I%=M%$+28:max$=LEN (title$) -2 

4040 REPEAT 

4050 A%t=INSTR(m$,","):IF At>max% maxt= 
AS 

4060 !1%=0:1%!4=0 

4070 $(1%+12)=LEFTS (m$,A%-1) 

4080 m$=MIDS (m$,A%+1) 

4140 1I%!8=&7000021:1%+=24 

4150 UNTIL mS="" 

4160 I%!-24=&80:M%! 16=maxt*16 

4170 ENDPROC RU] 
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TimeWatch provides the tools to manage appointments, a "To Do’ list of 
tasks, and jogs the memory for those important birthdays and 
anniversaries. TimeWatch retains your information in pages — there is a 
page for each day of the year, for as many years as desired. 


Start time, estimated duration and a descriptive note. All down a quick reminder, or notes 


Appointments. Appointments for the day are detailed by w, Short Notes. Useful for jotting 
appointments for the day are displayed in time sequence. of a telephone conversation. 


Tasks to do. Time Watch will help you plan your time and keep y itre Software i ti 
track of outstanding work by displaying your details of tasks in Limited 
one of the categories "Start Today’, ‘Ongoing’ or 'Overdue!’. i es 


Birthdays, anniversaries etc. Don't forget those things that should 26 Creechurch Lane 
not be forgotien. Details entered in this category will appear on ndon EC3A SBA 
the same page for all years. 01-283 4646 


TimeWatch can also search for a piece of text in any, or all, of your categories of information; print some, or 
all, of the information stored in a range of pages; and, by means of the perpetual calendar, move quickly from 
one page to another. 


For those who have made use of the Arthur 1.2 DeskTop Diary, TimeWatch will import the contents of the 


diary files. 
DiscTree 


provides comprehensive, and easy 

to use, facilities to display the 

directory structure of a disc, search 
, * for files and backup files. 


A TreeViewer provides the means to move rapidly 
around the directory structure of a disc and search for |) Special Offer: 
files. After specifying the directories to search, name and 
type to match the files found will be displayed, ready for 
loading into an editor. 


DeskTop Enhancer 
Users, DiscTree offer 
price: £39.95 [inc. VAT 
& p&p] on return of 

‘| original program disc. 


A backup is performed after specifying the 
directories to search, file name, type and date 
1o match. These criteria may be saved toa 
script file for fast and easy repeated use. 


Backup copies files matching your criteria to 
floppy discs. Files are spread over many discs 
required. Restore displays the contents of 
backup discs and allows the restoration of files 
by dragging to the required destination, or 
automatic restoration to their original locations. 


DiscTree and TimeWatch are written specifically for RISC OS desktop and make 
full use of the WIMP, multi-tasking and inter application communication. 


Prices: DiscTree: £49.95. TimeWatch: £29.95 [inc. VAT and p&p}. Limited 


ARM CODE SINGLE STEPPER 


Debugging a program written in machine 
code on any computer can be an absolute 
nightmare, and ARM code is no exception. 
Whether the elusive bug is a subtle one that 
causes the program to provide erroneous 
results, or a real humdinger which crashes 
the whole system, it can take ages just to 
find out where the bug is, let aloneput it right. 
One aid to debugging that can prove a 
godsend is a single stepper. Quite simply, 
what this does is to allow a program to be 
executed one instruction at a time, giving 
you the opportunity to examine the contents 
of memory and the processor registers after 
each instruction. This makes it much easier 
to identify where a problem has occurred. 


Hert lestrestion is : OO009004 SMT = 0S. rite 
“5 


hac instrection is : ORO09008 AOD = 8, 80,84 


oT 


the 


Tnhmatregran terniaated nornally. 


The program presented here is just such a 
utility, which is itself written in machine code in 
the form of a relocatable module. To use the 
module, enter the listing and save it. When 
run, the program will assemble the module 
and save it with the filename ‘SSTEP’. The 
module can then be installed by typing QUIT 
(to exit from Basic) followed by SSTEP. 


The SSTEP module provides a single 
command: 

*SINGLESTEP <address> 
which enters the single stepper ready to step 
through from the given address, which 
should be in hex. At this point you are 
presented with a ‘*’ as a prompt, which 
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signifies that the stepper is waiting for one of 
several single character commands to be 
entered. The possible commands are: 


R Display registers 

A Alter register 

Space bar Execute next instruction 

G Continue execution 

0,1,2 Set automatic display level 
N,Z,C,V,1I,F Toggle flags 

is OS Command 

Escape Terminate execution 


Most of the commands should be fairly 
self-explanatory. Perhaps the most important 
one is ‘Space’, which causes the next 
instruction to be executed. Initially, the ‘next’ 
instruction will be the instruction at the address 
specified in the *“SingleStep command. 
Normally, the program will be stepped through 
one instruction at a time. However, in the case 
of a Branch with Link (BL) instruction, you are 
given the option of whether you wish to trace 
the subroutine or not. If you answer no, then 
the entire subroutine will be treated as a single 
instruction. SWI calls are always treated as a 
single instruction. 


In some cases, you may wish to step 
through the first part of a machine code 
program, and then when you are satisfied with 
the operation, allow the program to run as 
normal. To do this, use the 'G’ command instead 
of ‘Space’. In this case, control of the program 
cannot be regained. Whenever a program 
executed via “SINGLESTEP terminates, a 
message to that effect will be displayed, and if 
an error occurs, this is displayed too. While 
single stepping, you can exit from the program 
prematurely by pressing Escape. 


The commands ‘0’, ‘1’ and ‘2’ control 
what information is displayed after each 
instruction is executed. Level ‘0’ causes no 
display, while level ‘1’ will display just the 
next instruction, and level ‘2’ will display the 
next instruction and a dump of the register 
contents. The default is level ‘1’. 


The ‘R' command will list the current 
contents of all the registers, together with the 
next instruction to be executed, the processor 
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mode, and the flag settings. To alter the 
contents of any register you can use the ‘A’ 
command, Selecting this will produce a ‘?' 
prompt. You should now enter the register 
number (in decimal), and the new value for it 
(in hex), separated by a space. For example: 

1 31FFC 
will set register R1 to &31FFC. A special case 
is if the register number is entered as 'P’. In 
this case, the Program Counter (PC) is altered 
without affecting the status bits in register R15. 
Therefore, this effectively performs a jump 
operation to alter the flow of control. To toggle 
the contents of the flags directly, press the key 
corresponding to the flag, thus: 

N Negative flag 
Zero flag 
Carry flag 
Overflow flag 
Interrupt disable flag 
Fast interrupt disable flag 


AIH CON 


For editing memory, any star command 
can be issued. You could for example, use the 
memory editor built into the RISC User 
Toolbox, or the *MEMORYA command 
supported by the RISC OS Debugger module. 


Should you wish to start debugging part 
way through a program, then this can be 
done by embedding a SWI call in your 
machine code, rather than using the 
*“SINGLESTEP command. The SWI used is: 

SWI “SingleStep StartStep” 
and has the number &CO0800. When this SWI 
is executed, the single stepper will be 
entered at the instruction immediately after 
the SWI. The registers will be retained 
exactly as they were before the SWI. You 
can then step through the remainder of the 
program exactly as for “SINGLESTEP. 


If you wish to study the workings of the 
single step module, then this month's 
magazine disc contains a fully commented 
version of the source code. See the inside- 
back cover for ordering details. 


10 REM > SingleP 

20 REM Program Single Stepper 
30 REM Version A 1.0 

40 REM Author David Spencer 
50 REM RISC User September 1989 
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60 REM Program Subject to Copyright 
80 DIM code 3000 
90 FOR pass=4 TO 7 STEP 3 
100 Ot=code:P%=0 
110 [OPT pass:EQUD 0:EQUD init 
120 EQUD 0:EQUD 0:EQUD title 
130 EQUD help:EQUD commtab:EQUD &C0800 
140 EQUD swi:EQUD switab 
150 .switab EQUS "SingleStep":EQUB 0 
160 EQUS "StartStep":EQUB 0:EQUB 0 
170 .title 
180 EQUS "SingleStepper":EQUB 0 
190 .help 
200 EQUS "Single Stepper":EQUB 9 
210 EQUS "1.00 (21 Jun 1989)":EQUB 0 
220 ALIGN 
230 .commtab 
240 EQUS "Singlestep":EQUB 0:ALIGN 
250 EQUD step:EQUD &10001:EQUD ssyn 
260 EQUD shelp:EQUB 0:ALIGN 
270 .shelp 
280 EQUS "*Singlestep invokes the mach 


ine code single stepper.":EQUB 13 


290 .ssyn 
300 EQUS "Syntax: Singlestep <start ad 


dress>":EQUB 0:ALIGN 


310 .init MOV R6,R14:MOV R3,#1024 
320 MOV RO, #6:SWI "XOS_Module" 
330 MOVVS PC,R6:STR R2, [R12] 

340 MOV RO, #0:STRB RO, (R2,#169) 
350 MOVS PC,R6 

360 .swi CMP R11, #0:MOVNES PC,R14 
370 LDR R12, [R12] :LDRB R11, (R12, #169] 
380 CMP R11,#0:MOVNES PC,R14 

390 STR R14, (R12, #14*4) 

400 BIC R14,R14, #&FC000003 

410 STR R14, (R12, #172] 

420 LDR R14, (R13,#4] 

430 BIC R2,R14, #&FC000003 

440 STR R2, (R12, #15*4] 

450 STMIA R12, {RO-R10}:B step2 
460 .step LDR R12, [R12] 

470 LDRB R1, (R12, #169) :CMP R1, #0 
480 MOVNES PC,R14:STMFD R13!, (R14} 
490 MOV R1,RO:MOV RO, #16 

500 ORR RO,RO, #1<<31 

510 SWI "XOS_ReadUnsigned" 

520 LDMVSFD R13!, {PC} 

530 BIC R2,R2, #&FC000003 

540 STR R2, (R12, #15*4] :MOV RO, #0 
550 MOV R1, #0 

560 .clear STR RO, [R12,R1] 
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570 ADD R1,R1, #4:CMP R1,#13*4 1080 MOV R1,R1,LSL #1:SUBS R2,R2,#1 

580 BNE clear:ADR R14,terminate 1090 BPL checkforflags:CMP RO, #ASC"A" 

590 STR R14, [R12, #14*4] 1100 BEQ alter:CMP RO, #ASC"R" 

600 .step2 ADD RO,R12, #1024 1110 BEQ registers:CMP RO, #ASC"G" 

610 STR RO, [R12, #13*4] 1120 BEQ go:SWI "OS WriteS":EQUW &D0A 

620 MOV RO, #patchend-patch 1130 EQUS "Unrecognised command" 

630 ADR R1,patch:ADD R2,R12, #68 1140 EQUW &DOA:EQUB 7:EQUB 0:B main 

640 .setpatch LDR R3, [R1],#4 1150 .go MOV R1,#1:STRB R1, [R12,#170] 

650 STR R3, [R2],#4:SUBS RO,RO, #4 1160 B execute 

660 BNE setpatch:MOV R1, #1 1170 .terminate MOV R1,PC:TEQP PC, #0 

670 STRB R1, (R12, #168] 1180 SWI "XOS_EnterOS":TST R1, #1<<28 

680 STRB R1, [R12,#169]:MOV R1,#0 1190 BNE error:SWI "XOS Writes" 

690 STRB R1, (R12, #170] 1200 EQUS "Program terminated normally. 

700 STR R13, [R12,#64]:B main “:EQUW &DOA:EQUB 0 

710 .patch STR R12,rl2save 1210 LDMFD R13!, {R14} 

720 STR R13,rl3save 1220 BICS PC,R14, #1<<28 

730 LDR RO, [R12,#15*4] 1230 .error SWI "OS Writes" 

740 AND RO,RO, #&6FC000003:MOV R1,R12 1240 EQUS "Program terminated with erro 

750 TEQP RO, #0:MOVNV RO,RO r:":EQUW &DOA:EQUB 0 

760 LDMIA R1, {RO-R14} 1250 LDMFD R13!, {R14} 

770 .here 1260 ORRS PC,R14, #1<<28 

780 LDR PC, [PC, #-(here+8-patch+8) ] 1270 .quit LDR R13, [R12, #64] 

790 .getback STR R14, [PC, #-(getback+8- 1280 SWI "OS_WriteS":EQUW &D0A 
patch+12)]:BL nextinst 1290 EQUS "Execution aborted." 

800 .nextinst STR R14, [PC, #-(nextinst+ 1300 EQUW &DOA:EQUB 0:MOV RO, #0 
8-patch+8) ] 1310 STRB RO, (R12, #169] 

810 .here3 1320 LDMFD R13!, {R14} 

820 SUB R14,PC, #there3+8-patch+68 1330 BICS PC,R14,#1<<28 

830 STMIA R14, {RO-R13} 1340 : 

840 SWI "OS _EnterOS":LDR R12,rl2save 1350 .star ADD RO,R12,#256:MOV R1,#256 

850 LDR R13,rl3save:LDR PC, return 1360 MOV R2,#ASC" ":MOV R3, #&FF 

860 .return EQUD 0 1370 SWI "OS ReadLine":BCC noesc2 

870 .rl2save EQUD 0 1380 .escesc MOV RO,#&7E:SWI "OS Byte” 

880 .rl3save EQUD 0 1390 SWI "OS WriteS":EQUW sD0A 

890 .patchend 1400 EQUS "Escape";EQUW &DOA:EQUB 0 

900 .main SWI &10A:SWI &10D 1410 B main 

910 SWI &100+ASC"*":SWI &120 1420 .noesc2 ADD RO,R12, #256 

920 SWI "OS ReadC":BCC notesc 1430 SWI "XOS_CLI":BVC main 

930 MOV RO,#&7E:SWI "OS Byte":B quit 1440 ADD RO,RO,#4:SWI "OS Write0" 

940 .notesc SWI "OS WriteC" 1450 B regout 

950 CMP RO,#ASC" ":BEQ execute 1460 : 

960 CMP RO,#ASC"*";:BEQ star 1470 .registers SWI &10A:SWI &610D 

970 CMP RO,#ASC"0":BCC notmode 1480 MOV R3,R12:MOV R4, #0 

980 CMP RO,#ASC"2":BHI notmode 1490 .reg2 SWI &100+ASC"R":MOV RO,R4 

990 SUB RO,RO,#ASC"0" 1500 CMP RO,#10:SWICS &100+ASC"1" 

1000 STRB RO, [R12, #168]:B main 1510 SUBCS RO,RO,#10:ADD RO,RO,#ASC"0" 

1010 .notmode BIC RO,RO,#&20 1520 SWI "OS WriteC":CMP R4, #10 

1020 MOV R1,#1<<26:MOV R2,#5 1530 SWICC &120:SWI "OS Writes" 

1030 ADR R3,flags 1540 EQUS " = ":EQUB 0:LDR RO, [R3], #4 

1040 .checkforflags LDRB R4, [R3,R2] 1550 ADD R1,R12,#256:MOV R2,#9 

1050 CMP R4,R0:LDREQ RO, [R12,#15*4] 1560 SWI "OS_ConvertHex8" 

1060 EOREQ RO,RO,R1 1570 SWI "OS Write0":SWI "OS Writes" 

1070 STREQ RO, (R12,#15*4] :BEQ main Continued on page 38 
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If your program is worth 
compiling, it’s worth 
compiling with 


ABC 


Confused about compilers? Look at the advantages of ABC over the competition 

* Truly RISC OS-based (drop files on the icon bar) 

* Compiler installs as a relocatable module 

* Compiles application, utility or service modules 

* Full implementation of ARM assembler 

* Into second version with all teething problems cured 

* Full syntax of INPUT and SWAP supported 

* Computed GOTO supported 

* Over 200 pages of friendly documentation 
Note that despite claims from our competitors, there is no limit (other than memory) 
on the size of arrays under ABC, full runtime error handling and local error handling 
is supported, as are LOCAL variables. Don’t take our word for it — a free working 
demo disc is available on request. 


Di sappoi nted with | sencxmanks (supplied on demo disc) 


Program BASIC V_ RB1.70 ABC 2,29 
H REPEAT...UNTIL 8.10 0.08 0,25 
RiscBASIC? WHILE...ENDWHILE 6.28 0.11 0.26 
FOR...NEXT ; 1.34 0,.00°° 
Upgrade to ABC for 30% off! | ackermanis,4) 30 0.27 0.07 
If you want fast, robust machine code from your oie : Ht re 
BASIC programs that you can depend on, why Not | string swap j 335 1.01 


try ABC? You won't be the first to upgrade. Send | string Add ; 6.44 1238 
£69.95 and your RiscBASIC disc, and we willsend | String Sort 3.02 0.19 
you a complete ABC Version 2 pack by return. | BASIC V version 1.04 running in RAM. RiscBASIC 
Upgrade offer price £60.83+VAT for UK customers. | and ABC speed imporvement directives used 
Cheque/PO/Access/Visa/Official orders accepted. | throughout, **ABC can eliminate emply loops like 
Order must be accompanied by an original disc from | this one. 

Silicon Visions’ RiscBASIC compiler. Normal price 
£99.95 (£86.91+VAT) 


DABS 


188s) 5 Victoria Lane, Whitefield, Manchester M25 6AL. Tel: 061-766 8423. Fax:766 8425 


MASTERING THE WIMP 


by Lee Calcraft 


This month we begin a new series on the Archimedes Wimp system. 
If you want to understand the Wimp and exploit it in your programs, read on. 


The Acorn Wimp is a very powerful and 
comprehensive piece of software available 
and accessible to all Archimedes users. It 
represents the state of the art in the 
excellent user interface which it creates. And 
more importantly it provides the means by 
which full co-operative multi-tasking is 
achieved on machines with RISC OS fitted. 


If you are among those who write programs 
on the Archimedes, and have not yet come to 
grips with the Wimp, then there are many good 
reasons why you should. As well as enabling 
your programs to multi-task, the Wimp also 
greatly simplifies access to filing systems. If 
your program needs to operate on data files, 
you do not need to write any code to find or 
display files, or move around the directory 
structure of the ADFS or Econet: the Desktop 
filer provides all this, and allows you to drag 
data files onto an application icon to run them - 
and much more besides. 


The Wimp presents the user with an 
easy-to-use, and intuitive interface. To 
the programmer it provides a very 
powerful structure within which to build 
his own code - which may be written in 
Basic, Assembler, or other high level 
languages such as C. The only real 
downside from the programmer's point 
of view is the complexity of the Wimp. 
But this is really quite unavoidable in 
view of the massive flexibility built into 
the system, as we will see in due course. 


Because of this complexity, we will be 
treating the whole subject in a measured 
fashion, with the intention of spreading 
the introduction of new concepts 
throughout the series. To make this 
possible, we will gloss over a number of 
areas early in the series, returning to 
them at a later date to fill in the gaps. 


Throughout the series we will be using 
Basic, and we will assume that you have RISC 
OS fitted in your machine (since the RISC OS 
Wimp is considerably more powerful than the 
Arthur Wimp). The best source of reference for 
the series will be the four-part RISC OS 
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Programmer's Reference Manual. Part two of 
the Arthur Programmer's Reference Manual 
constitutes a reasonable second best, but 
inevitably lacks information on the considerable 
RISC OS extensions to the Wimp. Should you 
have access to neither of these volumes, you 
should nevertheless find sufficient information 
within this series to make considerable use of 
the Wimp in your own programs. 


WINDOWS 

The acronym Wimp stands for Windows, 
Icons, Menus and Pointers. The software 
which handles this user interface in the 
Archimedes is a resident module called the 
Window Manager, often referred to as the 
Wimp. A typical window is shown in figure 1, 
and it is assumed that you are familiar with the 
effect of clicking the mouse when the pointer is 
over the various parts of the window. If not, 
switch on your machine, and find out! 


Closeicon ,, Title bar Toggle size 
e wx a icon 


[=] < Scroll up 
icon 


Slider 


Visible work area 


—+— Scroll bar 


| <— Scroll down 


window size 
Horizontal Scroll right icon 


Slider ‘scroll bar eae 


Figure 1. Archimedes window layout 


The really excellent thing about the Acorn 
Wimp is that not only will it place windows on 
the screen exactly where you want them, but 
it will fully maintain them as well. For 
example, if the user drags a window to a 
new position on the screen, then the 
manager will handle this for you. Only if part 
of the window needs redrawing (as it would if 
it had previously been obscured by another 
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window) will your program need to do 
anything, and in such cases the Wimp will 
tell your program exactly which parts of the 
window need updating. This means of 
course that a dialogue must be struck up 
between your program and the Wimp, and 
we will see how this works in due course. 


WIMP SYS CALLS 


Virtually all access to the Wimp is via so- 
called SWI calls, or their Basic equivalent, 
the SYS call. If you are unfamiliar with SYS 
calls, you are referred to the brief article in 
this issue: SYS Calls Explained. There are a 
staggering 52 Wimp calls documented in the 
RISC OS Programmer's Reference Manual, 
but we will start by concentrating on the use 
of just nine of these - see table 1. 


In very broad 
terms, a Wimp 
program will begin 
by making a call to 
Wimp_lInitialise. 
This informs the 
Wimp of the exis- 
tence of the new 
task (or program), 
and if the task has 
not been run from 
the Desktop, it will 
set up the mode, 
colour palette and 
pointer. At the 
same time, the 
Wimp issues the task with a so-called task 
handle. This is a number unique to that 
particular task, which may be used when 
referring to the task in future dialogues. 


Wimp_Initialise 
Wimp_CreateWindow 
Wimp_OpenWindow 
Wimp_GetWindowState 
Wimp_Poil 


Wimp_RedrawWindow 
Wimp_GetRectangle 
Wimp_CloseDown 
Wimp _ReportError 


Table 1. Some 
commonly used 
Wimp calls 


In order to open a window on the screen, 
the program must next make a call to 
Wimp_CreateWindow. In this call, the program 
provides a large block of data for the Wimp 
which precisely defines the window and the 
way in which it will behave. This block contains 
details of the exact size and position of the 
window, whether it has scroll bars, what its 
component colours are and so on. 


Although it defines the window, this call 
does not cause it to be drawn on the screen. 
A second call, Wimp_OpenWindow, is used 
for this purpose. And even then, nothing will 
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actually appear until a so-called Wimp Poll 
takes place. The Wimp_Poll SWI call is 
central to the whole operation of the Wimp. It 
is this call which is used to maintain the 
dialogue between each particular task and 
the Wimp, and it is by means of this call that 
the Wimp achieves multi-tasking. 


In all Wimp programs there must be a 
central routine which makes repeated calls 
to Wimp_Poll. The Window Manager 
responds to these calls by returning a value, 
called the reason code, to the calling 
program (or task), and the task in turn 
responds to this. The reason code may 
indicate that the user has clicked on an icon 
in the task's window, or that he has typed at 
the keyboard, or whatever. In any case, it is 
up to the task to interpret the reason code, 
react accordingly, and then call Wimp_Poll 
again to find out what to do next. 


Unbeknown to each task, the Wimp multi- 
tasks through this Wimp_Call. What happens 
is that the Wimp returns to each task in turn, 
so that in the time between a task calling 
Wimp_Poll, and getting back a reason code, 
the Wimp has serviced each of the other 
concurrent tasks in turn. This is all handled 
completely by the Wimp, and all that each task 
must do is to call Wimp_Poll in a central 
REPEAT loop, and to respond as quickly as 
possible to the reason code which the Wimp 
returns, and then call Wimp_Poll again, so 
passing control back to the Window Manager. 


It should be stressed at this point that al/ 
Wimp programs must behave in this way. No 
special code over and above this is needed 
to accomplish multi-tasking. Whether or not 
a Wimp program multi-tasks depends on the 
way in which it is called. If it is run from 
Basic, then it behaves as a straightforward 
Basic application. If it is run from the 
Desktop, then it will multi-task with any other 
programs currently running. For specific 
details on multi-tasking you are referred to 
the two-part article “Multi-Tasking with RISC 
OS" in RISC User Volume 2, Issues 3 and 4. 


A SIMPLE PROGRAM 


To see how this all works in practice, we 
will take a look at the program in listing 1. 
This creates and maintains a single resizable 
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window containing text and graphics. To try 
the program, type it in carefully, and save it 
away before running it. There are two ways 
to run it: it can be run just like any other 
Basic program by LOADing it into RAM, and 
typing RUN (or combining the operations 
using CHAIN), or alternatively you can 
double click on the program's icon from the 
Desktop. The advantage of the former 
approach is that when you quit the program 
by clicking on the “X” icon at the left of the 
title bar, your program will still be in RAM, 
from where it may be edited, and re-run. 


lf you run the program from the Desktop, 
you will see that it multi-tasks happily with 
any other task currently running, but with the 
disadvantage that when you leave the 
Desktop (either by selecting Exit, or using 
Ctrl-Shift-F12), the program will not be 
recoverable, and must be re-loaded from 
disc if you wish to edit it. 


Incidentally, if you are running the 
program from the Desktop, you will probably 
not be able to start up any further tasks once 
the program is running (including clones of 
the program itself), because there is 
insufficient RAM. This is because the RISC 
OS Task Manager has allocated large 
quantities of free RAM to the task. You can 
stop this from happening by invoking the 
Task Manager Window. Click with the Menu 
button over the “A” icon at the right hand 
side of the icon bar at the base of the 
screen, and allocate just 16 or 32K to the 
“Next task” before running the program. We 
will deal with a special call for allocating 
RAM to each task in a future issue (but if you 
need to know now, see the article “Creating 
RISC OS Application Directories” in RISC 
User Volume 2 Issue 4 page 20). 


Next month we will look in some detail at 
this program, and see how the various Wimp 
calls are made. In the mean time you may like 
to experiment a little. First of all check that the 
program behaves itself correctly, in a multi- 
tasking environment. Do all the icons produce 
the expected result when clicked? Can the 
window be dragged properly? And can you 
spot the inconsistency in the way in which the 
window is updated? Running more than one 
copy of the program may make this clearer. 
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The test window is resizable, and may 
be scrolled. You can multi-task as 
many clones of it as you wish by 
repeatedly double-clicking on its icon 
from the Desktop. 


If you want to experiment further, try 
altering the six parameters of FNcreate at 
line 220. The first two are the x and y co- 
ordinates of the bottom left hand corner of 
the visible part of the window. The second 
two are the width and height of the visible 
part of the window, and the last two are the x 
and y dimensions of the hidden part of the 
window i.e. the part of the window which is 
initially hidden, but which can be made to 
appear by clicking on the scroll bars or by 
resizing the window. More on all this next 
month. 


10 REM >!RunImage 
20 REM Program Simple Wimp Demo 
30 REM Version A 0.12 


40 REM Author Lee Calcraft 
50 REM RISC User September 1989 
60 REM Program Subject to Copyright 


80 DIM block% &200 
90 ON ERROR PROCerror:END 


110 quitt=FALSE 


150 $blockt="TASK" 
160 SYS "Wimp Initialise", 200, !block%, 
"Test" TO versiont,task% 


on) | a) Lea) (1) a) [7 


Ea} (Ea) 5) 1S 
iS) 


ines now 
inspection RISC OS G 


copy aeevies COMPATIBLE [gq 


Have you 

spent long hours struggling 

with the programming complexities of the brilliant 
Archimedes WIMPS system? 


YOU can easily and quickly build multi-window programs for Archimedes with pop-up 
menus, icons, mouse control, etc. of a professional quality. All in BBC Basic. With RISC 
OS your programs are multi-tasking and installed on the icon bar. 


ARCHWAY provides a total environment for programming with tools, run-time code, 
program shells, extensive examples and a library of functions and procedures. 


The tools let you define and edit windows, multi-level menus, icons, mouse pointers 
and much more. The cut, copy and paste, undo, on-line help and hard copy print-out 
facilities give you power as well as ease of use and convenience. 


The run-time code becomes part of any program you create. It automatically handles 
windows, menus, icons, etc. for you. For example, opening a window can involve little 
more than calling a function with the window's name. Attach a menu name to a window 
using the tools and the menu functions without you writing a line of code. Give amenu 
item a command name and when a user chooses it a function in your code with the same 
name is called. You just write the contents of the function. 


An in-depth user guide takes you gently step-by-step through £79 9 5 
a progressive series of program building examples. All ° 
examples are on disc ready to run. incl. VAT & p/p 
The complete system comes on 4°800k discs (3 tools & 1 run-time) with a 300+ page, ring- 
bound user guide. You need 1M of RAM to run the tools, One disc drive is sufficient. No 
extra licence fee to distribute copies of the run-time in your programs. 


AVAILABLE SOON: A Major New Release (VI. 1). Many new features; eg powerful 
graphics and text facilities for your programs by multitasking cooperation with the RISC 
OS Draw, Edit and Paint programs. BUY ARCHWAY NOW AND UPGRADE WITHOUT 
FURTHER CHARGE! 


Sh SUMTAGN were 


4 CLARENCE DRIVE, EAST GRINSTEAD, 
WEST SUSSEX RH194RZ_ _— Telephone (0342) 328188 


Cheques/POs/official orders or Access/Visa number and PVA | 
Access expiry date. 24-hour ‘phone for Credit Card orders. LY 
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CREATE WINDOW 


200 REM x,y,width, height, extx%, exty% 
210 REM extx% & exty% are hidden parts 
220 whandlet=FNcreate (200, 200,300,500, 


200,200) 


230 REM---------------~--~-------------- 
240 REM 
250 REM-~~--~-~-~--~------~-----------=--- 
260 block! 0=whandlet 

270 SYS "Wimp _GetWindowState",, block’ 
280 SYS "Wimp OpenWindow", ,block% 

290 REM-------------------—--------==-- 
300 REM 
310 REM------------------------------- 
320 ON ERROR IF FNwimperror THEN END 
330 REPEAT 


MASTERING THE WIMP 


700 blockt!44=-vwht-exty% : 

710 block$!48=vwwt+extx% :REM WAE x2 

720 blockt!52=0 H 

730 blockt!5€=&3D:REM Title icon flags 

740 block%!60=3<<12;:REM Work area flgs 

750 $(block%+72)="Test Window" 

760 SYS "Wimp CreateWindow",,block% TO 
handlet% 

770 =handle% 

780 : 

790 DEFPROCredraw 

800 block$! 0=whandlet 

810 SYS "Wimp RedrawWindow",,block% TO 
more’ 

820 PROCgetorigin (block%, x0%, y0%) 

830 WHILE more% 

840 PROCdraw (x0%, y0%) 


340 PROCpoll 850 SYS "Wimp _GetRectangle",,blockt 


350 UNTIL quit’ TO moret 
360 $block%="TASK" 860 ENDWHILE 
370 SYS "Wimp_CloseDown",task%, !block% 870 ENDPROC 
380 END 880 : 
390. REM- << nnn enn nnn 890 DEFPROCgetorigin (block%t,RETURN x0% 
400 : RETURN y0%) 
410 DEFPROCpoll 900 x0%=block%! 4-block%!20 
420 SYS "Wimp Poll",,block% TO reasont 910 yO%=block$! 16-block%! 24 
430 CASE reason%t OF 920 ENDPROC 
440 WHEN 1 :PROCredraw 930 : 
450 WHEN 2 : !blockt=whandlet:Sys 940 DEFPROCdraw (x0$%, y0%) 
"Wimp OpenWindow", , block’ 950 SYS "Wimp_SetColour",11 
460 WHEN 3 : quit %=TRUE 960 MOVE x0%, y0%-40 
470 WHEN 17,18:IF block%!16=0 THEN q 970 PRINT TIMES 
uit $=TRUE 980 SYS "Wimp SetColour", 10 
480 ENDCASE 990 CIRCLE FILL x0%+100,y0%-400, 50 
490 ENDPROC 1000 ENDPROC 
500 : 1010 : 
510 DEFFNcreate (vwx%, vwy?, vww%, vwht, ex 1020 DEFPROCclose 
txt, exty$) 1030 $block%="TASK" 
520 $blockt=STRINGS (88,CHRS$0) :REM Clr 1040 SYS "Wimp _CloseDown", task%, !blockt 
530 REM Visible Work Area 1050 ENDPROC 
540 block! 0=vwx% :REM x1 1060 : 
550 blockt!4=vwyt :REM yl 1070 DEFPROCerror 
560 blockt! 8=vwxt+vwwt :REM x2 1080 ON ERROR OFF 
570 block$!12=vwyt+vwht :REM y2 1090 Sblock="TASK" 
580 blockt!24=-1:REM no winds above 1100 SYS"Wimp_CloseDown", task%, !block% 
590 block’! 28=éFFOQ00Q00F:REM wndow flg 1110 PRINT REPORTS$;" at line ";ERL 
600 REM Window Colours 1120 ENDPROC 
610 blockt?32=7 :REM Title fgnd 1130 : 
620 block%?33=2 ;:REM Title beg 1140 DEFFNwimperror 
630 blockt?34=7 ;REM Work area colour 1150 !blockt=ERR 
640 block*?35=1 :REM Work area bcg 1160 $(block%+4)=REPORT$+" at line "+ST 
650 blockt?36=3 :REM Scroll bar beg RSERL+CHRSO 


660 block$?37=1 :REM Scroll bar fgnd 
670 blockt$?38=12 :REM Title bar hlght 
680 REM Work Area Extent 
690 blockt!40=0 
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1170 SYS "Wimp ReportError",block$, 3, "T 
est Window" TO ,responset 
1180 IF responset=2 THEN PROCclose:=TRU 


:REM WAE xl E ELSE =FALSE 


NEW! See ARCHIMEDES 
ad BBC/MASTER 
DISC 1 COMPACT 
Pare includes Jonathon ELK 
Partington's latest release (ACP +4) 
AVON, in which you take the 
part of a tourist strangely lost in 
The Bard's home town. Mysteriously 
transported into the world of His plays 
and players, your aim is to find out how to 
return to the present day. An exhaustive 
knowledge of the Shakespearean Canon is 
NOT necessary, Includes MURDAC free! 
£19.95 


DISC 2 features the best of Peter Killworth: 
much-expanded versions of PHILOSOPHER'S 
QUEST & COUNTDOWN TO DOOM, and his 
latest release (Part 2 of his ‘Doom’ trilogy) 

RETURN TO DOOM. All three games only 
£19.95 


DISC 3 includes the biggest-ever micro adventure 
ACHETON, together with a much-enhanced 
version of KINGDOM of HAMIL. Two best- 
sellers for £19.95 


DISC 4 features Peter Killworth's popular 

mathematics adventure game, 
Prices GIANTKILLER. Used in schools 
include all over Britain, this adventure 
VAT for 10 to 14 year olds is a 
and p&p real maths challenge. 

Only £19.50 

telephone 


0733 244682 


PO Box 39 
Stilton 


P’BORO PE7 3RAL 


& 24hours 


Features; 


Multi-layer design 
Accepts up to 4 podules 
Co-processor option 

12 month warranty 
Easy to install 

High quality 

fan/ filter unit 


+ + + + 4 F 


introduces 
NOArI 
PROFESSIONAL 
PAINT 
the compatible graphics program for 


the Archimedes 


fERY yrapticn horrrval jabs 


rested (xapte 


GMA mbH, 38 Upper Weilheads, Limekiins, FIFE, Scotland 


INTRODUCING THE FIRST MULTI-LAYER 
4-SLOT BACKPLANE FOR ARCHIMEDES 


The 4-slot backplanes currently available for the Archimedes are all intended to do an identical 
job. They may even look very similar, but the fact is they are not the same. 


Whereas cheaper backplanes use a simple double-sided circuit board, ours is a true multi-layer 
design. This is particularly effective in reducing electrical noise. Indeed, our backplane has 
already been shown to work in situations where a double-sided version did not. 


Having compared several 4-slot backplanes 
from different sources, Computer Concepts 
have given approval to ours because of its 
superior performance. 


The A440 is fitted with a multi-layer 
backplane. Since multi-layer boards are 
more expensive to manufacture, it is 
reasonable to assume that it has been 
considered necessary for technical reasons. 


28 day no-quibble money-back guarantee. 


A data sheet is available upon request. 
Write or "phone for our free current price list. 


Prices (including VAT) 


Approved 
Seon £6438 Pre ne VAT, et eas —— 
2 sbt ‘anknlans £19.95 allow £1 postage (UK/CI/BFPO). , 
Fun/filser for above £10.00 Official orders welcome. Order with IFEL 
Acorn 20Mb hard disc £499.00 Access on (0752) 847286 sisi esleen 
New RISC OS £35.00 Plymouth PLS 6BD 


Postage is £1.00 | yOr (0752) 847286 


(0752) 847286 
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THE SPARK ARCHIVER 


David Spencer takes a look at a Desktop archiver and file compressor. 


Subscribers to the RISC User magazine 
disc may recall that in the past we have 
published two versions of a utility called Arc 
as a bonus item. Arc is a command line 
driven utility which both compresses and 
bundles together files. Given a set of files, 
Arc will combine them into a single file, the 
length of which will be less than the 
combined lengths of the individual files. The 
main use for which Arc is intended is in the 
downloading of files from bulletin boards and 
viewdata systems. These typically use 
archived files, especially with IBM PC 
programs, both because they take up less 
room, and also because it is much simpler to 
download a single file than a group of them. 
Because Arc is designed to cope with 
several standard archive formats, it is 
possible to decompress many files with it, 
though the actual decompressed files may 
not be of much use if they are for another 
system. Now, David Pilling who implemented 
Arc on the Archimedes, has followed the 
RISC OS philosophy and developed a multi- 
tasking Desktop version called Spark. 


When Spark is installed, it places an icon 
on the iconbar. Pressing the Menu button 
over the icon offers Quit and Info options, 
and a New archive option. Selecting this 
pops up a save box from which to create an 
empty archive. Archive files are represented 
by a picture of Noah's Ark. Dragging an 
archive onto the iconbar icon will open a 
pseudo directory viewer, and new files can 
be added to the archive by dragging them 
into this viewer. Similarly, file are recovered 
from the archive simply by dragging them 
out. Menu options allow you to change the 
archive format, and the archiving method, so 
that it is possible, for example, to archive 
only files that are newer than the version 
already in the archive. Other options allow 
the archive to be encrypted using a 
password, and the integrity of the archive 
checked to see if the files are all readable. 


DOCUMENTATION 


The ‘user guide’ comes in the form of a text 
file on the disc and a short application to 
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display it. These notes detail how to use Spark, 
and any possible problems. While they are 
relatively short, they are perfectly adequate for 
what is a very easy-to-use product. 


BONUS ITEMS ? 


Included on the Spark disc are a couple 
of public domain programs. The first of these 
is the RISC User Dustbin which was 
originally published on the magazine disc for 
Volume 2 Issue 6, For readers who haven't 
seen it, this allows files to be deleted by 
dragging them into the bin. The second 
bonus item is a utility to make the Desktop 
‘sticky’. This allows objects to be dragged 
out of directory viewers and placed 
anywhere on the Desktop background. 
Thereafter, the system will remember where 
the object came from (and hence actually is), 
and there is even a facility to save the 
Desktop so that when it is restarted all the 
objects are there. While at first sight this 
appears to be a very useful utility, it suffers 
from the major drawback that it falls over if 
the original of any file on the Desktop is 
deleted, moved or renamed. 


CONCLUSION 

| can see two main reasons why people 
would use Spark. Firstly, for its original 
purpose of packaging files for transfer via 
modems, and secondly for compressing files 
when making an archive, or a backup, of a 
hard disc. In the first case, Spark performs 
the task with ease. However, although the 
file compression is very good (in terms of 
space saved), each archive file has to fit on 
a single floppy. Therefore, to make a backup 
of an entire hard disc, it is much simpler to 
use a dedicated backup utility. Whatever 
your needs, if you feel that Spark would be 
useful, then you really can’t go wrong at 
under £6. 


Spark Archiver 


David Pilling, 
PO Box 22, 


Thornton Cleveleys, 
Blackpool FY5 ILR. 
£5.99 inc. VAT and p&p 


| 
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ARCHIMEDES SOFTWARE 


HOME ACCOUNTS, = ANCESTRY 
£49.95 £79.95 


Keep your home or club finances in order 
Full control of multiple bank accounts 


The ultimate in computerised genealogy! 
for use in families or pedigree animals. 
including credit cards and building Use added card index for extra data or 
societies. Budgeting facility to assist photos of individuals. Demo file 
cashflow prediction. Graphs of contains illustrated Royal Family 


budgets and expenditure. Caters tree, Vertical or horizontal 
for standing orders, transfers, ATELI EE printout of family tree. 
£99.95 


statement reconciliation, etc. For home, hobby or 
x 6392-4)77% ® 


(Multi-tasking if using educational use 
RISC OS ) (RISC OS compatible) 


Access & 
Barclaycard 
accepted 


Prices 
inclusive 
of VAT 


Professional quality art package. Probably the most 
sophisticated sprite editor available. Animation of image 
sequences with Quantel-style graphic effects. Anti-alias 
squashing, rotation of areas into any quadrangle, and sprite and 
brush patterning, Further features allow TV-style techniques to 
even wrap a picture around a 3D surface. 
(Multi-tasking if using RISC OS.) (To be released soon) 


PIA INE RNP A 


69 SIDWELL STREET, EXETER. EX4 6PH Tel: (0392) 437756 Fax: (0392) 421762 


A POP-UP FILE SELECTOR 


Graham Crow presents a Basic function to implement a pop-up file selection box. 


Because of space constraints, this program 
is included on the magazine disc only. 

While the RISC OS Desktop provides a 
consistent and simple-to-use interface for 
loading and saving files, not 
everyone will want to write their 
programs to use the WIMP. 
However, this doesn't mean that 
you cannot have a consistent and 
user-friendly file selector, as this 
program shows. The basic 
principle is that whenever a 
program wishes to access a file, it 
calls the generalised file selector 
which allows the user to move 
between discs, and up and down 
directories, ultimately selecting a 
file. The full pathname of this file 
is then returned to the program, 
which is free to do whatever it 
likes with the file. 


USING THE PROCEDURE 

The file selector function is 
contained on disc as part of a 
demonstration program. When 
this is run you will be 
presented with a blank screen 
with the file selector in the centre. This box 
will be similar to that shown in figure 1. 
Working round the box: at the top is a title 
which can be specified by the main program. 
Below this are two boxes, a small one 
showing the drive number, and a larger one 
with the name of the currently displayed 
directory. To the left of these are two arrows 
which can be used to step through the 
available drives. This is done using the 
pointer and the Select button. At the right is 
an arrow which can be used to move up a 
level in the directory tree. If you change the 
disc in the drive, clicking on the drive number 
window will mount the new drive. 


The large area in the centre of the 
selector shows the entries in the current 
directory. Files are shown by name, along 
with their filetype in both hex and as a name. 
Entries will be greyed out if their filetype 
doesn't match that specified by the main 
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File: !RunInage- 


program. Sub-directories are shown in red, 
with a down-arrow to the right of the name. 
Pressing Tab will change the display to show 
the access and length of each file, instead of 
the filetype. A further press of Tab reverts 
back again. Clicking on a non-grey filename 
will select it and cause its 
name to appear in the bottom 
box, while clicking on a sub- 
directory will display its 
contents. Once a file has been 
selected, the name in the 
lower box can be edited, and 
clicking on OK will return the 
full pathname to the main 
program. Clicking on CANCEL 
will return without a name. 
The demonstration program 
will merely display the 
selected filename. If there are 
more files than can be fitted 
on the display, then the two 
arrows to the right of CANCEL 
will move up and down by a 


page. 


USING THE SELECTOR IN 


YOUR OWN PROGRAMS 
Incorporating the file 
selector function into your own program is 
relatively easy. The best way to understand 
how this is done is to study the 
demonstration program. You will need to 
include all the code from line 320 onwards in 
your own program. The main function is 
FNfiler, but before calling this you must call 
the initialising procedures, as in line 150. 
This sets up various variables, and also the 
colour palette. The function FNfiler takes five 
parameters thus: 
path$=FNfiler (left, top, lines, head$, type) 
The parameters /eft and top specify the 
position of the top left of the window in terms 
of characters, while /ines specifies the 
number of lines to use for the file display. 
head$ is the heading to give to the window, 
and type is the particular filetype that should 
be recognised. A value of -1 indicates that all 
file types are valid. The function returns the 
full pathname of the selected file, or a null 
string if cancel is selected. 


3] 


REVIEWS 


fitelier from Minerva 


Reviewed by Mike Williams 


Art packages have proved a popular 
commercial offering for the Archimedes, at 
least from the suppliers’ point of view. 
Minerva has now joined the fray with Atelier, 
a mode 15 painting package of some 
sophistication, but readers may be forgiven 
for wondering whether another such 
package is really needed. 


Unlike previous art packages, Atelier has 
been designed to work from the outset within 
the RISC OS Desktop environment, but | 
have to report that otherwise Atelier appears 
to offer little that is significantly different to 
that which is already available through such 
packages as Art Nouveau (reviewed in 
Volume 2 Issue 5) and ProArtisan (see 
Volume 2 Issue 3). In this review I shall 
therefore concentrate on only those features 
which seem particularly deserving of a 
mention. 


For your money you receive a single 3.5” 
disc, a 92 page manual and a reference 
card. This includes a keystrip to be cut out, 
as well as two labelled screens for use as a 
reference with Fill Style and Colour Menu. 
The packaging follows Minerva's usual style, 
but more colourful and attractive than has 
often been the case in the past. 


From the Desktop, Atelier is installed on 
the icon bar. Double clicking on its icon 
changes the display to a full screen painting 
area, with a panel showing the Minerva logo 
and Atelier title which can be removed). 
From within Atelier, pressing F8 will return 
you to the Desktop, where you can change 
memory allocations for fonts and sprites, for 
example, using the Task Manager. Clicking 
on the Atelier icon returns you to your 
current picture with all options set as before. 


Atelier is controlled by a hierarchical 
menu system activated with the Menu button 
of the mouse. Press Select to choose any 
menu option, including sub-menus. Moving 
the pointer outside the menu area causes 
the menu to disappear instantly. This may 
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sound undesirable, but as Minerva suggests 
in the documentation, one soon becomes 
accustomed to this, and | found the whole 
menu system, with some practice, easy and 
efficient to use. 


The Atelier Colour Menu 


Colour control is quite complex (Minerva 
would no doubt argue ‘quite 
comprehensive’), and a Colour Menu can be 
displayed by a second click of the mouse 
when any other menu is already on the 
screen. The Colour Menu merits further 
attention, as with practice | found it to be one 
of the most important and useful features of 
Atelier. You can, of course, select any colour 
from the 256 available. There are also 
Red/Green/Blue slide bars as an alternative 
way of choosing colours. 


A second panel gives a choice of 16 sets 
of tints of a single shade, but tints can also 
be created for other user-generated colours. 
It is possible too, to reduce the range of tints 
in a set, and to switch between light to dark 
or dark to light. It is also possible to set a 
repeat so that painting can cycle through a 
range of tints (for example, to paint the 
leaves of a tree in various shades of green). 


The other (third) main panel of the Colour 
Menu deals with what Minerva calls Priority 
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Colours. When a priority colour (or colours) is 
in operation, painting only changes the other 
colours. For example, this can be used so that 
a new object can be drawn to appear behind 
an existing object (by making its colour a 
priority colour). It can also be used to change 
just one colour into a new one, without 
affecting the rest of the display. This will also 
work with a range of tints, either overwriting 
the tints only, or overwriting everything else 
only. The Colour Menu takes some mastering, 
but it is crucial to using Atelier effectively. 


The Colour Menu also controls the choice 
between paint, patterns and sprites when 
creating pictures. There are separate pattern 
and sprite editors, and both patterns and 
sprites can be saved to disc for reloading. 


Atelier contains all the features which we 
have come to expect from an art package: 
the ability to draw straight and curved lines 
and shapes, including three-point curves. 
Brushes may be in a variety of sizes and 
snapes, or you can define your own. A spray 
brush is also available, and all brushes can 
use paint, patterns or sprites. 


Likewise, the Fill option can also work 
with paint, patterns and sprites, and with a 
range of tints. A separate Fill Style menu 
provides various controls, allowing 
graduated shading in a variety of styles. 
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filelier from Minerva 


The text option uses anti-aliased fonts, 
but you must allocate sufficient font space, 
and load the required fonts from the RISC 
OS Applications Disc 1 first. You then enter 
the text and create a box of the size and 
shape you want, and Atelier will 


automatically scale and position the text. 
The manual claims that Atelier will also 
work with the outline fonts (to be available 
with some DTP packages), but | was unable 
to test this. 


Many other features of Atelier are much 
as you would expect, and | list the more 
important below. 


Magnifier and pixel editor 
Define and copy part of picture 
Distort copy over user-defined shape 


Copy and resize part of the picture using 
anti-aliasing 

Pixellate a picture 

Sprite editor 


Bottle copy to wrap a picture round a 
three-dimensional object 

Formula copy to create mathematical 
surfaces 

Sequencer to animate picture sequences 


Use of function keys to ‘undo’ actions 


fitelier from Minerva 


DOCUMENTATION 

The Atelier manual is, by and large, well 
written and easy to follow. Working through 
the so-called ‘Experimental’ section provided 
an excellent and quite 
comprehensive 
introduction to the 
software. The reference 
section also reads well, but 
is not quite as detailed as 
perhaps it should be. | do 
have two gripes with the 
manual. The illustrations 
appear to have been taken 
directly from screen 
displays (this even 
includes captions and 
labels), but the rendering 
of various shades of colour 
in patterns of dots leads 
to highly unreadable 
text. This is important, as 
the illustrations are often 
an integral part of an 
explanation. 


Secondly, | disagree 
(as | am sure will many 
artists and designers), at 
the manual's oft assertion that you only need 
Atelier to become the next Salvador Dali or 
Renoir of the art world. Any skilled craftsman 
will tell you that a tool is only as good as the 
user, and no software package will turn a 
dullard into an imaginative and highly 
regarded designer. 


CONCLUSIONS 

Atelier’s competitors are clearly Art 
Nouveau and ProArtisan. As far as price is 
concerned, Atelier occupies the middle 
ground. | quite liked Atelier, and feel sure it 
would suit many Archimedes users. Art 
Nouveau is also very good value for 
money, but with fewer facilities. ProArtisan 
is the Rolls Royce in this market, and a lot 
of time and effort has gone into its 
production. 


| have to confess that personally | dislike 
ProArtisan's highly graphic and often 
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unintelligible use of icons, although Atelier is 
not entirely without this failing either. At the 
end of the day your choice will depend on 
the answers to two questions: which 


package will allow you to do the things you 
want to do, and which best suits your own 
style of working. | suggest you consider both 
these points with care. 


Given that Atelier will work fully within the 
Desktop environment (although not 
completely multi-tasking), that, together with 
its very full specification, would make it my 
choice. However, do not dismiss ProArtisan 
out of hand just because of its price, while 
Art Nouveau still provides an excellent and 
easy-to-use introduction to the world of multi- 
coloured art. 
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o Yo CALLS EXPLAINED 


by Lee Calcraft 


The so-called SYS call (or its ARM code 
equivalent the SWI call) is a special call which 
gives the user direct access to operating 
system routines. And although many simple 
Basic programs make no recourse to SYS 
calls, there are in fact many operations which 
cannot be performed without their use. The 
Wimp is a case in point, being accessed 
almost exclusively via such calls. 


The Archimedes has a potential 16777216 
such Calls in its repertoire, though only a 
relatively small number are actually defined. 
Each SYS or SWI call has an identification 
number, and if you are in Basic, then each may 
also be referred to by name. For example the 
two Calls: 

SYS “OS WriteC" 
and sys 0 
are equivalent. Their effect is to output a single 
character to the current VDU stream (normally 
the screen). The character to be output must 
be supplied as a parameter. To output the letter 
“A" for example, you would write: 

SYS "OS WriteC", 65 
since 65 is the ASCII code for “A”. 


Generally speaking it is always best to 
supply the SYS name rather than its number, 
since this makes your code easier to follow. 
But if you are using the name, it must be 
entered exactly as it appears, right down to the 
case of each letter. If you entered the SYS 
name as “Os _WriteC” you would get the error 
“No such SWI", You should also be careful with 
the so-called underscore character used in all 
SYS names. This is produced by pressing Shift 
together with the minus key. Note also the 
vitally important comma separating the SYS 
name and the parameter. If you miss this out 
you will get a syntax error signalled. 


In practice almost all SYS calls take one or 
more parameters. OS _Plot takes 3. For 
example: 

SYS "OS Plot", 4,100,200 
This call would move the graphics cursor to 
point 100,200 (4 is the plot code for move 
absolute). In fact the sequence of parameters 
supplied to SYS calls represents values which 
will be placed in sequence into ARM registers 
RO, R1, R2 etc. when the call is executed. 
Sometimes you will see that one or more 
parameters have been omitted from a call by 
placing the separating commas adjacent to 
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each other. When this happens, the operating 
system inserts a value of zero in the 
corresponding ARM register. Thus if we issued 
the following: 
SYS "OS Plot",4,,200 

this would move the graphics cursor to the 
point 0,200 - the second parameter of the call 
(the x co-ordinate) being set to zero. 


Sometimes when large quantities of 
information must be passed to a SYS call, a 
so-called parameter block is used. This 
happens with most Wimp calls. In such cases, 
the user builds up a data block in RAM 
containing the information needed by the SYS 
call, and then passes the start address of the 
block as one of the parameters of the call. 


SYS calls can also return information. 
“OS _ Mouse” for example, returns the pointer 
co-ordinates, button state and time of button 
change. It might be used as follows: 

SYS “OS Mouse" TO x%,y%,button%, time% 
Here, as in all cases where no parameters are 
supplied, the comma after the SYS name may 
be omitted. After this call, the four variables 
following the word “TO” will hold the values 
returned by the call. As with the parameters 
supplied by the user, the return parameters 
reflect the contents of ARM registers RO, R1, 
R2 etc. And again, if a particular register in a 
sequence is to be ignored, the comma 
separators can be moved together. Thus: 

SYS "OS Mouse" TO ,,button$ 
would still return the button state. 


Finally, to illustrate how supplied and return 
parameters are used together, the following 
OS_Byte call will read CMOS RAM location 
n%, and store the result in the variable 
result%: 

SYS "OS Byte" 161,n% TO ,,result% 

Note the two commas before the variable 
result%, indicating that the value returned in 
this variable should be the contents of ARM 
register R2 (RO, and R1 being discarded). To 
test this out, try it with n%=147. The variable 
result% will return the number of pages of 
sprite space configured in your machine. 


For further details on this topic, see the 
Programmer's Reference Manual, which 
documents each equivalent SWI call, giving 
the contents of all relevant ARM registers 
before and after execution. 
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ANNOUNCING A MAJOR NEW SOFTWARE RELEASE 


Circle Software are proud to announce a major new software release for 
the Archimedes. Premier is so new, there is as yet no defined category 
for it. Is it a word processor? Is it a report generator? Is ita 
spreadsheet or a data base? Premier fits none of these categories, 
rather it spans them all. Premier is a major advance in capability from a 
single program. These are just some of its features - 


The ability to read and execute commands from files allows any text processing 
to be carried out just by typing a ‘star’ command, or picking from the desk-top. 
Further, the ability to define ‘macro’ commands, and to assign these to ANY key, 
allows complete ‘applications’ to be built, including customised spreadsheets, 
and simple data bases. A command file defining a full featured word processor, 
with matching key-strip, is included with Premier. 


This word processor alone justifies the purchase of Premier. It allows text to be 
moved between any number of files open at once, searches to be made 
forwards or backwards using powerful pattern matching, document headers and 
footers to be defined, has on screen formatting and other features too numerdus 
to list here. The command file defining this may be edited to tailor the features to 
your own requirements, a feature not found in any other word processor. 


DYNAMIC TEXT is a new concept which allows the inclusion of variable items 
within any document. Such items may show today’s date or time, the current 
value of VAT, or a name and address. The actual text displayed may be 
computed, defined at the keyboard, or read from a data file. This system 
facilitates the production of statements and invoices, financial reports, or 
personalised maii shots. 


Premier's powerful command language, which includes maths and string 
functions, repeat loops and ‘if - then’ constructs, may be included in the 
definition of a DYNAMIC TEXT item, allowing full spread-sheet type facilities 
anywhere on the page, not just in neat rows and columns. This also allows 
printer codes to be sent, providing the simplest method yet devised to control 
printer functions from embeded commands. 


Now fully RISC-OS Multi-tasking. 


Weonbratrwiatesne’ Circle Software 


di the full version of Premier. 
sc or the full version emie 33, Restrop View, 


Price including 160 page —- Purton, Swindon, 
KY manual and applications, Wilts. SN5 9DG 
£96 +VAT, post free. | Tel: 0793 770021 


BRAINSOFT MULTIPLE I/O PODULE UPDATE 


In last month's RISC User | reviewed 
Brainsoft's new multiple function podule, and 
found it wanting in a number of respects. 
Brainsoft have kindly sent me a new board to test. 
This shows evidence of component changes 
around the analogue input area of the board. 


As far as the video side of things is 
concerned, the alterations certainly seem to 
have done the trick. The frame grabber now 
works properly. The quality of the grabbed 
image is quite reasonable, though not as 
crisp as that produced by the much more 
expensive Watford unit. One particularly 
noticeable point is that successive grabbed 
images of the same picture vary in quality. 
This is a consequence of the hardware, and 
the only solution is to repeatedly grab a 
particular image until you are happy with the 
result. 


| also reported that the analogue input 
gave erratic results when connected to a 


stable resistive source. This problem still 
occurred on the new board, 


On this month's magazine disc we include 
a frame grabbed by the digitiser from a 260 
line resolution VHS c video camera. 2 


“FIRST 


ADVANCED STATISTICAL SYSTEM 


For Acorn Archimedes; BBC Models B, B+ and Master; ‘industry Standard” machines 
A powerful and practical tool for Research, Industry, Business, and Teaching 


Integrated, interactive, robust, fast, accurate, modular. Designed to facilitate data critique. 

Many data entry options. Full data management and formatted display. Extensive data transforms. 
Handles missing variables and data subsets. Scatterplots, regression plots, function plots. 
Univariate statistics. Paired and unpaired t tests. Chisquare tests. Nonparametric methods. 

Unrivalled REGRESSION facilities eg weighted, through the origin, standardised. Full statistical information. 


Residuals, fitted and predicted values. Much more. Correlations. ANOVA. Contour plots of regressions. 
Regression DIAGNOSTICS - VIFs, influential points etc. Automatic warnings. 
ROBUST regression - many influence functions. Powerful NONLINEAR least squares 
Time Series, eg moving averages, exponential smoothing, causal models, 
One- Two- and Three-way ANOVA subsystems. Distributions generator. Histograms. Linear Calibration. 
Cluster analysis. Many other powerful analytical and descriptive features. Full utilities. 


Price £120-£180 (machine and version dependent). Special RISC USER discount available. 
There's far too much to describe here. Get full information now from: 
Serious Statistical Software, Lynwood, Benty Heath Lane, Willaston, South Wirral L64 ISD Tel. 051 327 4268 
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ARM CODE SINGLE STEPPER (continued from page 21) 


EQUS " ";EQUB 0:ADD R4,R4,#1 
TST R4,#3:SWIEQ &10A:SWIEQ &10D 
CMP R4,#16:BNE reg2:BL disinst 
SWI "OS Writes” 

EQUS "Processor is in ":EQUB 0 
AND RO,R3,#3:ADR R1,modes 

LDR RO, [R1,RO,LSL #2] 

SWI "OS_WriteC":MOV RO0,R0,LSR #8 
SWI "OS WriteC":MOV RO0,RO0,LSR #8 
SWI "OS WriteC":SWI "OS Writes" 
EQUS " mode":EQUW &DOA:EQUB 0 
AND R3,R3,#&FC000000:CMP R3, #0 
BNE reg3:SWI "OS Writes" 

EQUS "No flags set":EQUB 0 

B regout 

-reg3 ADR Rl, flags 

MOV R2,#6:SWI "OS Writes" 

EQUS "Flags set are : ":EQUB 0 
.reg4 LDRB RO, [R1],#1 

MOVS R3,R3,ASL #1 

SWICS "OS WriteC":SUBS R2,R2,#1 
BNE reg4 

.regout SWI &10A:SWI &10D:B main 


-»modes EQUS "USR FIQ IRQ SVC " 
.flags EQUS "NZCVIF":ALIGN 
.disinst MOV R10,R14 

SWI "OS Writes" 

EQUS "Next instruction is : " 
EQUB 0:LDR R3, [R12,#15*4] 

BIC RO,R3, #&FC000003 

ADD R1,R12, #256:MOV R2, #9 

SWI "OS_ConvertHex8" 

SWI "OS Write0":SWI 6120 

BIC R1,R3, #&FC000003 

LDR RO, [Rl] 

SWI "Debugger Disassemble" 
MOV RO,R1:SWI "OS WriteO":SWI &10A 
SWI &10D:MOV PC,R10 


-alter SWI "OS WriteS";:EQUW &DOA 
EQUS "2? ":EQUB 0:ADD RO,R12, #256 
MOV R1,#256:MOV R2,#ASC" " 

MOV R3,#&FF:SWI "OS ReadLine" 
BCS escesc:ADD R1,R12, #256 
.alter2 LDRB RO, [R1l],#1 

CMP RO,#ASC" ":BEQ alter2 

BCC regout:CMP RO, #ASC"P" 

BNE alter3:LDRB RO, [Rl], #1 

CMP RO, #ASC" ":BNE badalter 

MOV R2,#16:B alter4 

-alter3 SUB R1,R1,#1:MOV RO, #10 
ORR RO,RO, #1<<29:MOV R2,#15 


SWI "XOS ReadUnsigned" 

BVS badalter 

-alter4 MOV R3,R2:MOV RO,#16 

SWI "XOS_ReadUnsigned":CMP R3, #16 
BEQ alter5:STR R2, [R12,R3,LSL #2] 
B main 

-alter5 LDR RO, [R12,#15*4] 

MOV RO,RO,ROR #2 

AND RO,RO, #&FF000000 

MOV RO,RO,ROR #30 

BIC R2,R2,#&FC000000:BIC R2,R2, #3 
ORR RO,RO,R2:STR RO, (R12, #15*4] 

B main 

-badalter SWI "OS Writes" 

EQUW &D0A:EQUS "Bad alter":EQUB 0 
B regout 

-execute SWI &10A:SWI &10D 

BL findnext:LDRB Rl, (R12, #170) 
CMP R1,#1:BEQ execute2 

ADR R1,terminate:CMP RO,R1 

BEQ execute2:LDR Rl, (R12, #172] 
CMP RO,R1:LDREQ Rl, [R12,#14*4] 
ORREQ R1,R1, #1<<27 

STREQ R1, [R12, #14*4] 

.execute2 MOVEQ R1, #0 

STREQB R1, [R12, #169] 

STRNE RO, [R12, #160] 

LDRNE Rl, [RO]: STRNE R1, (R12, #164] 
ADDNE R1,R12, #getback-patch+68 
SUBNE R1,R1,R0:SUBNE R1,R1,#8 
MOVNE R1,R1,LSR #2 

ORRNE R1,R1, #&EA000000 

STRNE Rl, [RO] :ADRNE RO,backin 
STRNE RO, (R12, #return-patch+68] 
ADD PC,R12,#68 

-backin LDR RO, [R12, #160] 

LDR RI, [R12,#164]:STR R1, [RO] 
LDR RI, (R12, #15*4] 

AND R1,R1,#&FC000003:ORR R1,R1,RO0 
STR R1, [R12, #15*4] 

LDRB RO, (R12, #168) 

SUBS RO,RO,#1:BMI main 

BNE registers:SWI "OS NewLine" 
BL disinst:B main 


.findnext MOV R11,R14 

LDR RO, (R12, #15*4] 

BIC RO,RO, #&FC000003 

LDR R1, [RO]:LDR R2,addinst 

AND R1,R1,#&F0000000:ORR R1,R1,R2 
STR R1, (R12, #256) 

LDR R1, jumpback 
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2640 STR R1, [R12, #260) 

2650 ADR R14,ccdone:MVN R2,#0 

2660 LDR R1, (R12, #15*4] :ORR R1,R1, #3 
2670 TEQP R1,#0:ADD PC,R12, #256 

2680 .ccdone CMP R2,#0:ADDNE RO,RO, #4 
2690 MOVNE PC,R11:LDR R1, [RO] 

2700 BIC R1,R1, #&F0000000:SUB R2,R1, #1 
2710 CMP R2,#&F000000:BEQ oswrites 
2720 CMP R1,#&C000000:BCS sequential 
2730 CMP R1,#&A000000:BCS branch 

2740 CMP R1,#&8000000:BCS block 

2750 CMP R1,#&4000000:BCS transfer 
2760 CMP R1,#&400000:BCS notmult 

2770 AND R2,R1, #&90:CMP R2, #&90 

2780 BEQ sequential 

2790 .notmult AND R2,R1, #sF000 

2800 CMP R2,#&F000:BNE sequential 
2810 AND R2,R1, #&F<<21:CMP R2, #8<<21 
2820 BCC dprocess:CMP R2, #12<<21 

2830 BCC sequential 

2840 .dprocess AND R4,R1, #&F0000 

2850 MOV R4,R4,LSR #16:AND R5,R1,#6F 
2860 AND R6,R1, #&F00:MOV R6,R6,LSR #8 


2870 BIC R1,R1,#&F000:BIC R1,R1, #&F0000 


2880 ORR R1,R1,#&10000 

2890 ORR R1,R1, #6E0000000 

2900 TST R1,#1<<25:BNE dprocimm 

2910 BIC R1,R1,#&F:ORR R1,R1,4#2 

2920 TST R1,#16:BICNE R1,R1,#6F00 

2930 ORRNE R1,R1, #&300 

2940 .dprocimm STR Rl, (R12, #256) 

2950 LDR Rl, jumpback:STR R1, (R12, #260] 
2960 LDR R1,(R12,R4,LSL #2] :CMP R4,#15 
2970 BICEQ R1,R1,#&FC000003 

2980 LDR R2,{R12,R5,LSL #2] 

2990 LDR R3,{(R12,R6,LSL #2] 

3000 ADR R14,dprocdone:ADD PC,R12, #256 
3010 .dprocdone BIC RO,RO, #&FC000003 
3020 MOV PC,R11 

3030 : 

3040 .sequential ADD RO,RO, #4 

3050 MOV PC,R11 

3060 .oswrites ADD RO,RO, #4 

3070 .oswrites2 LDRB R1,[R0],#1 

3080 CMP R1,#0:BNE oswrites2 

3090 ADD RO,RO,#3:BIC RO,RO, #3 

3100 MOV PC,R11 

3110 .branch MOV R4,RO:ADD R2,R0,#8 
3120 BIC R3,R1, #&F000000 

3130 MOV R3,R3,LSL #8 

3140 ADD R3,R2,R3,ASR #6 

3150 CMP R1,#&B000000:BCC noquestion 
3160 SWI "OS WriteS” 
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3170 
3180 
3190 
3200 
3210 
3220 
3230 
3240 
3250 
3260 
3270 
3280 
3290 
3300 
3310 
3320 
3330 
3340 
3350 
3360 
3370 
3380 
3390 
3400 
3410 
3420 
3430 
3440 
3450 
3460 
3470 
3480 
3490 
3500 
3510 
3520 
3530 
3540 
3550 
3560 
3570 
3580 
3590 
3600 
3610 
3620 
3630 
3640 
3650 
3660 
3670 
3680 
e,0% 


ARM CODE SINGLE STEPPER 


EQUS "Follow branch to ":EQUB 0 
MOV RO,R3:ADD R1,R12, #256 

MOV R2,#9:SWI "OS ConvertHex8”" 
SWI "OS Write0":SWI "OS Writes” 
EQUS " (Y or N) ? ":EQUB 0 

SWI "OS_ReadC":BCC notesc2 

MOV RO, #&7E:SWI "OS Byte” 

MOV RO, #ASC"N"™ 

-notesc2 BIC R0,RO,#&20 

CMP RO, #ASC"Y":MOVNE RO, #ASC"N" 
SWI "OS _WriteC":MOV R1,RO 

SWI "OS NewLine":CMP R1, #ASC"Y" 
MOVNE RO,R4:BNE sequential 
-noquestion:MOV RO,R3:MOV PC,R11 
-block TST R1,#1<<20 

TSTNE R1, #1<<15:BEQ sequential 
MOV R2,R1,LSR #16:AND R2,R2,415 
LDR R2, [R12,R2,LSL #2) 

TST R1,#1<<23:BNE indexedup 

TST R1, #1<<24:SUBNE R2,R2,#4 

B getnewpc 

.indexedup MOV R3, #0 

MOV R4,R1,LSL #17 

.regcount MOVS R4,R4,LSL #1 

ADC R3,R3,#0:CMP R4,#0 

BNE regcount:ADD R2,R2,R3,LSL #2 
TST R1, #1<<24:ADDNE R2,R2, #4 
»getnewpc LDR RO, (R2] 

BIC RO,RO, #&FC000003:MOV PC,R11 
-transfer TST R1,#1<<20 

BEQ sequential:AND R2,R1,#&6F000 
CMP R2,#&F000:BNE sequential 
AND R4,R1, #&F0000 

MOV R4,R4,LSR #16:AND R5,R1, #6F 
BIC RO,R1,#&FFO00:TST RO, #1<<25 
BICNE RO,RO, #&F 

ORR RO,RO, #6E0000000 

ORR RO,RO,#&10000:ORRNE RO,RO, #2 
STR RO, [R12, #256] :LDR RO, jumpback 
STR RO, [R12, #260) 

ADR R14,transfer2 

LDR RI, [R12,R4,LSL #2] 

CMP R4, #15 

BICEQ R1,R1, #&FC000003 

LDR R2, (R12,R5,LSL #2]:CMP RS, #15 
BICEQ R2,R2, #&FC000003 

ADD PC,R12, #256 

.transfer2 BIC RO,RO, #&FC000003 
MOV PC,R11 

-addinst ADDEQS R2,R2,#1 

. jumpback MOV PC,R14:)]NEXT 

SYS "OS File",10,"Sstep", &FFA,,cod 
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Now you've got RISC OS 
you need its companion. 


The RISC OS Companion Volume 1 


Essential utilities to enhance the already 
very powerful RISC OS Desktop. 


!Terminal a multi-tasking terminal emulator 

{StartUp creates !Boot applications for floppy or hard discs 
!Notes a note taking addition to !Edit 

!Options makes setting copy and wipe options easy 
!TheBin for deleting files by dragging over an icon 


!GenBoot creates applications for Arthur 1.2 programs 
[FileType makes setting file types easy 

!Cachelt caches icons and file types for quick loading 
!StarComms adds star commands to a menu 


PLUS utilities to convert View and WordWise files to 
1st Word Plus and !Edit 


All 100% Riscware 


£49.95 ex VAT from all good Acorn dealers 
(20% discount for education) 


Site/area licences available directly from 
Software Solutions 


— Broadway House, 149-151 St Neots Road, 
S SOFTWARE) Hardwick, Cambridge CB3 7QJ 
= [SOLUTIONS — Te. 9954 211760 Telecom Gold 74:YKK255 


, ye 


PREVIEWS | 


RISC OS COMPANION 


Reviewed by David Spencer 


RISC OS Companion Volume 1 is the first 
product from Software Solutions, a new 
company which aims to produce fully legal 
RISC OS software. So has their first offering 
lived up to that claim? The Companion is really 
a set of small RISC OS Desktop applications 
designed to perform a variety of tasks. Before 
any of the utilities can be used, you need to 
make a working copy of the disc and merge 
the ‘System directory from the companion disc 
with the equivalent directory from Applications 
Disc 1. This is because all the programs have 
been compiled using ABC2 (see RISC User 
Volume 2 Issue 8), and therefore need the 
runtime library in the ‘System directory. 


THE UTILITIES 

A large number of the utilities are for 
converting text files. There are programs to 
convert from Edit; Wordwise Plus and View 
into 1st Word Plus; from Wordwise Plus and 
View into Edit, and from Edit into 1st Word 
Plus. These all sit on the iconbar and you 
simply drag files onto them, and then drag 
the converted file to a directory viewer. 
Wherever possible, the conversions maintain 
highlights and formatting within the text. 


There are four utilities which | would class 
as being system related. The first of these is a 
filetype converter which will change the 
filetype of any file dragged onto it to a 
specified type. Then there is a utility to set up 
the copy options used by the Desktop. This 
can be quite useful, particularly as the 
Desktop will not, by default, overwrite existing 
files. Of course, all these options can be set 
up using “SET. TheBin is a dustbin similar to 
the one published on the RISC User 
magazine disc. However, it has the 
disadvantage that files are deleted 
immediately, and cannot be dragged out 
again. StarComms must surely be the most 
useless of the utilities. It allows a number of 
star commands to be issued, though | am 
sure that most users would find it much easier 
to press F12 and type the command directly. 


Three of the most useful commands are 
StartUp, Cache, and GenBoot. The first of 
these will set up a /Boot file so that 
autobooting will enter the Desktop with your 
particular choice of applications installed, 
and directory viewers open. Cache builds up 
a list of files and their corresponding 
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applications, so that a file can be run before 
its application has been ‘seen’, while 
GenBoot is a utility to simplify the process of 
transferring Arthur applications to RISC OS. 
The final two utilities are a note-taking facility 
for Edit, and a very simple teletype terminal 
which could be used with a modem for 
logging on to Telecom Gold and the like. 


RISCWARE 

Riscware is a new term coined to mean 
software that follows the standards and style 
of applications such as Edit. The Companion 
claims to be Riscware, and indeed at first 
sight it does appear so. However, there are a 
few discrepancies. For example, Acorn state 
that if you wish to close a file-save box without 
performing a save, then you should do this by 
pressing Escape. With the Companion, 
though, this is done using a quit icon on the 
save box. Whatever the merits of either 
approach, the consistency which Acorn has 
tried to lay down is lost. Similarly, there are a 
number of dialogue boxes in which options 
are set by clicking on an ‘OK’ button, but can 
be left unset by clicking on the window's close 
icon. | would much rather have seen a 
‘CANCEL’ button, as it is then immediately 
obvious what the exact effect is going to be. 


Worst of all, when | tried to drag a 
directory into one of the file converters, rather 
than complaining nicely, it splatted a text 
error across the screen and hung up with the 
hourglass on. Very friendly for a new user! 


CONCLUSION 

This is the sort of product that users will 
buy for just one or two of the utilities, but at 
the high cost of the Companion, | suspect 
that purchasers will be few in number. 
However, it is nice to see the appearance of 
Desktop utilities, and | am sure that this will 
not be the only such product to be released. 
However, most of the utilities will be of use to 
some people, and it is nice to see Riscware 
products appearing. 


RISC OS Companion Volume | 
Software Solutions, 

Broadway House, 

149-151 St Neots Road, 


Hardwick, Cambridge CB3 7QJ. 
Tel. (0954) 211760 
£57.45 inc. VAT 


4% TWO 40 MBYTE HARD DISCS 


Since we reviewed the Acorn and 
Watford 20Mbyte hard disc upgrades for the 
A310 a couple of months ago, a number of 
faster, larger capacity drives have become 
available for the Archimedes. In this review 
we will take a look at two of these units. 


The drives se- 
lected for the 
review are a 
Toshiba 40Mbyte 
unit with an access 
time of 25 msecs, 
supplied by Tech- 
nomatic, and a 35 
msec Fujitsu drive 
of similar capacity 
marketed by GES 
Computer sup- 
plies. Both drives 
come with cables 
and full fitting 
instructions. For 
the purposes of the 
review, we used an 
Archimedes 410/1. 
These new machines 
have a built-in hard disc interface with a 
drive indicator LED already installed. Either 
drive is easily fitted inside the computer, 
and plugs directly into the sockets on the 
main board. 


The drives would equally well suit an 
A310, however, providing a hard disc 
expansion card is fitted to the backplane. 
Both Watford and Acorn supply suitable 
cards for their drives. 


Fitting the drives was a relatively easy 
matter. The outer casings of both have 
holes matching those on the disc drive 
fixing bar at the front of the computer, 
though you need to take care not to strip 
the thread from the small self-tapping 
screws (Acorn - please thread the fixing 
holes on the disc drive mounting bar!). In 
the case of the Fujitsu unit (but not of the 
Toshiba), one of the fixing flanges was 
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offset so as to avoid having to share a 
fixing hole with the floppy drive. 


A further small negative point about the 
Toshiba drive is that the mounting frame 
must be unscrewed in order to plug in the 
Arc's power supply 
feed to the drive. 
This is a little 
awkward, since it 
means that you 
have to screw it all 
back together again 


while it is con- 
nected to the 
relatively short 


power lead within 
the computer. But 
this is not really a 
problem, and both 
drives were easily 
installed. 


Once your hard 
disc has been phys- 
ically installed in the 
computer, you must 
tell the machine of its existence by typing: 
*Configure HardDiscs 1 

And of course, before use, the drives must 
be formatted (though GES will supply their 
drives formatted if you request it). To format 
a new drive, insert the RISC OS Support 
Disc (supplied with RISC OS upgrade kits 
and with the 400/1 series machines) into 
your floppy drive, and from the Desktop open 
up the Acorn directory, and run the file: 


Hform 


This goes through a dialogue process, 
and you can make use of the information 
supplied with either of the drives to answer 
the questions set. All hard discs will carry 
defective sectors, and with both the drives 
supplied, these were indicated on a sheet 
fixed to the body of the drive. When 
formatting the disc, you can either inform 
the formatter of the positions of the defects, 
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as supplied, or you can use the 
“soak test” option (selectable from 
Hform). In the latter case, the 
formatter formats the drive, 
ignoring defects, and then 
perpetually checks the disc for 
read/write errors. GES suggest 
that you leave this running for 12 
hours. 


When you finally press the 
space bar to terminate the soak 
test, the formatter very quickly 
writes the map using the information 
gathered during the soak test; and the 
formatting process is complete. It then only 
remains for you to organise a sensible 
directory structure, and to transfer all your 
most-used files from floppy disc. 


COMPARING THE TWO DRIVES 

Both drives gave a similar speed 
performance on the tests carried out (see 
table 1). The timings for the standard 
20Mbyte Acorn drive are given for 
comparison, and as you can see, the new 
drives are significantly faster. 


Parking cylinder 7663 


Current Defects (Cylinder Head, Sector) 
(20,9,3 


fy no mare changes 

Bi add defect by cylinder, head, byte/sector 
€: ada defect by disc address 

i renove de! 


One feature that | particularly like in the 
Toshiba unit is its auto-parking facility. As 
soon as the power is switched off, the heads 
park automatically, and there is no need to 
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remember to issue the command “BYE 
before switching off. 


As far as noise is concerned, the Fujitsu 
drive appears a little quieter than the 
Toshiba. The former generates about as 
much noise as the Arc's internal fan. Both 
units are built to a high standard, though the 
Fujitsu casing perhaps has a slight edge 
over its rival. 


Both drives behaved very reliably over a 
period of several weeks’ intensive use. And 
that leaves only the price. The Fujitsu drive 
is a little dearer than the Toshiba, and the 
auto-parking facility may further sway you in 
the direction of the latter. But if on the other 
hand you are keen on keeping noise levels 
as low as possible, then the Fujitsu may be 
for you. 
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Science Frontiers hardware... 
Archimedes WINCHESTER Hard Disk Upgrades 


* Fujitsu 40 Mb (formatted) Fast Hard Disks 


* ACORN Hard Disk Controller Podule 
Upgrade kits for all Archimedes: 310, 310HD, 410, 420 and 440 


310 410 310HD, 420, 440 
Fujitsu Hard Disk Fujitsu Hard Disk Fujitsu Hard Disk only 
Acorn HD Podule Cables and Metalwork (Replacement drive to 


all Cables and Metalwork (Controllerin machine) give increased storage) 


...£540.00 ...£379.00 ...£365.00 


Fujitsu are Japan’s number one manufacturer Order from: 
of reliable high-performance disk drives. 


GES Computer Supplies 
Hard disks are 3.5" 35 ms, 625KB/s internal Granitehill Enterprise Centre 
fitting and are completely Acorn RISC-OS Granitehill Road 
compatible, Drives will be formatted and Northfield 
soak-tested on request. Aberdeen AB2 7AX 
Larger drives are also available. Please call Tel: 0224-698545 
i ee requirements or for All prices include P&P but 
arther ceteils: exclude VAT. 


G.E.S. Computer Supplies: Official Acorn Dealer 
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Science Frontiers software... 


First Word Plus 
Extended Dictionary 


* 80,000 word 
Main Dictionary 


A BIGGER, BETTER DIARY 
for the Archimedes 


Choice of three diary sizes. 
You can have several active diaries and choose the | 
sizes, up to 15 lines of 40 characters, to suit the task, 
with more than one year for each task. Easy to use with 
on-line HELP. The program is fully WIMP based, and ff 
i} multitasks with RISC-OS. 


|} See a full year at a glance. | 
A single window shows part of the entry for every day of 

the year, See the free days or spot that elusive entry at a 
glance. A string search facility enables lost entries to be 
found. 


Specialised 
Supplementary 


Dictionaries 
(Computing Terms, Proper Names, 
Geographical Locations) 


instant viewing of the full entry for any day. 
| Skim the mouse over the year to scan the full entries for 
i] any day and just ‘click’ on a day to make an entry. To-day's 
entry can be kept on screen for reference. 


Print all of a month with just one command. 
Select the month, or months, to be printed. Then choose 
from either a full page formatted print-out, or a quick 
single line per day, showing only those days which have 

an entry. ] 


£6.95 inclusive 


£14.95 
(incl. VAT & U.K.p&p) 
| Cheque or P.O. to Official Orders also welcome. 
QUERCUS COMPUTER SYSTEMS 
Courtyard House. North Otterington 
Northallerton. N. Yorks. DL7 9EP 


Order from: Science Frontiers 
7 Porthill Court 
Aberdeen 
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Into the ARC 


This month Mike Williams looks at the provision for looping and branching 
in Basic V. 


Readers of RISC User may recall that in 
the first article in this series (Volume 2 Issue 
7) | presented an overview of the whole 
process of writing a program. That process, 
to be successful, depends upon creating a 
clear structure for your program. In turn this 
means making frequent use of functions and 
procedures, the subject of last month’s 
article. It also requires a good understanding 
of the branching and looping constructs 
provided on the Archimedes by Basic V. 


The idea that a program can be written so 
that a certain section of code is repeated (a 
loop), or that a program can be made to 
choose between two or more different routes 
through the program (branching) is 
fundamental to the whole concept of 
programming (and indeed was first 
formalised by one of the founders of modern 
computing, von Neuman, in 1947). 


LOOPS 

The simplest form of loop can be set up 
using a GOTO statement to refer to a 
previous line in a program, but as | have said 
before, GOTOs do not lead to clear 
programs, and on the whole are to be 
avoided when possible. For example, it is 
only when you reach such a GOTO ina 
program that you realise that the preceding 
coding forms part of a loop anyway, as there 
is nothing which explicitly indicates where 
the loop begins. 


Basic, on all computers, provides an 
obvious looping mechanism in the form of 
the FOR-NEXT statement, which is ideal 
when we want to repeat a group of 
instructions a ‘known’ number of times. This 
uses any variable of our choice to count the 
number of times the instructions are to be 
repeated. In its simplest form we might, as 
an example, write: 

FOR m = 1 TO month 

READ month$ 

NEXT m 

DATA January, February, March . 
where the value of month determines one of 
the months in the year whose name we wish 
to read from a set of DATA statements. The 
variable m simply counts from 1 (the starting 
value) up to the value of month. A FOR- 
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NEXT loop always begins with the keyword 
FOR and terminates with the keyword NEXT, 
so it is always easy to recognise such a loop 
in any program, and you will find many 
examples to study in the programs listed in 
RISC User. 


By default, FOR-NEXT loops always 
count upwards in steps of 1, but you can 
count both up and down in whatever step 
size you wish by specifying this with the 
keyword STEP. For example: 

FOR x = 40 TO 1240 STEP 100 

LINE x,0,x,1024 

NEXT x 
would draw a series of vertical lines (in the 
current graphics colour) at intervals of 100 
graphics units across the screen. 


A few comments at this stage may not go 
amiss. If the loop counts upwards the 
starting value should be smaller than (or 
equal to) the final value; for counting 
downwards the reverse should be true. 
Loops can be nested one within another, but 
must not overlap. And never put the NEXT 
into any form of conditional statement (IF- 
THEN-ELSE) - even if you get it to work it is 
bad practice, and any later changes can 
cause no end of trouble. 


There is also a particular problem with 
the implementation in BBC Basic (though 
this does not necessarily apply in all versions 
of Basic). Consider the following example: 

100 PRINT"Times to toss a coin"; 

110 INPUT n 

120 heads=0:tails=0 

130 FOR toss=1 TO n 

140 value=RND (2) 

150 IF value=1THEN heads=heads+l ELSE 
tails=tails+l 

160 NEXT toss 

170 PRINT”Heads ";heads;" tails ";tails 

180 END 
This is designed to count the number of 
times heads or tails will appear in tossing a 
coin. Lines 140/150 will randomly assign 
either 1 or 2 to value each time the loop is 
repeated. 


Now logically, we would expect that if the 
answer to the initial question (and hence the 
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value of n) happened to be given as 0, then 
the loop would not be executed at all. In fact, 
it will still be executed once, giving an 
incorrect result. A FOR-NEXT loop will 
always be executed at least once, even if the 
starting and terminating values suggest that 
this is wrong. This is something you need to 
be aware of whenever you use the FOR- 
NEXT construction. 


However, Basic V provides two further 
ways of controlling loops which behave 
more logically. These alternatives also 
control loops in a fundamentally different 
way. FOR-NEXT should be used only when 
the number of repetitions is known at the 
start of execution of the loop. The 
alternative is to repeat a section of the 
program until some condition is satisfied. 
For example, we may wish to search (or 
read) through a list of names until a 
particular name is found. We don't know 
where in the list the required name might 
be so we cannot count through the names 
to find it. 


The two alternatives (in BBC Basic) are 
REPEAT-UNTIL and WHILE-ENDWHILE. 
The former will repeat a group of instructions 
until some condition is satisfied, but note the 
order - perform the task unti/ complete. Many 
programs consist of a main loop which is 
repeated until the user decides to exit from 
the program, and this is often expressed as 
a REPEAT-UNTIL loop: 

exit%=FALSE 

REPEAT 

PROCdisplay menu 
optiont=FNselect_option 
PROCexecute (option) 

UNTIL exit’ 


This outline program uses a variable 
exit% to act as a flag in the program. Initially 
the flag is set to be FALSE. The main loop is 
presumed to display a menu on the screen 
from which the user makes a choice, and the 
program then performs the selected task. It 
assumes that one of the menu choices is an 
exit from the program which if selected 
causes exit% to be set to TRUE. When this 
happens the program exits from the 
REPEAT-UNTIL loop because _ the 
terminating condition has been satisfied. 
Again, you will find many of the programs 
which we publish contain examples of this 
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structure, presented in outline above (using 
procedure calls). 


There are many situations in most 
programs where a REPEAT-UNTIL form of 
loop is the natural choice, whether as a 
major feature, or as minor component. Here 
is a simple example of a REPEAT-UNTIL 
loop which is used quite commonly in many 
programs: 

REPEAT 

GS$=CHR$ (GET AND &DF) 

UNTIL GS$="Y" OR GS$="N" 

The loop is repeated until either ‘Y’ or ‘N’ is 
pressed (GET AND &DF converts any lower 
case letters to upper case before testing). 
This can be extended into a useful little 
function: 

1000 DEF FNask (text$) 

1010 LOCAL G$ 

1020 PRINT text$+"?"; 

1030 REPEAT 

1040 GS$=CHRS$(GET AND &DF) 

1050 UNTIL G$="Y" OR G$="N" 

1060 =(G$="Y") 

This will display any message supplied as 
the parameter of the function, and return the 
value TRUE if the answer is ‘Y' (for yes) or 
FALSE if ‘N' (for no). For example, you might 
put in a game: 

100 PROCstart 

110 REPEAT 

120 PROCplay game 

130UNTILFNask ("Finish game") 

140 END 


However, note that the terminating 
condition is only tested after the body of the 
loop has been performed at least once. Thus 
a REPEAT-UNTIL loop suffers the same 
restriction in this respect as does a FOR- 
NEXT loop. 


This is not so with the other form of 
conditional loop, the WHILE-ENDWHILE 
construction. Because this form of loop is 
less well known, it is worth defining its syntax 
a little more carefully than we have done 
hitherto. It takes the form: 

WHILE <condition> 

<statement (s)> 

ENDWHILE 
As long as the specified condition remains 
true, the body of the loop will continue to be 
executed. If the condition is not satisfied at 
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all, the following action will never take 
place.For example, we might write: 

xpos=640: ypos=512 

WHILE (xpos>xl AND xpos<x2) AND 
(ypos>yl AND ypos<y2) 

PROCmove (xpos, ypos) 

MOUSE xpos, ypos, state 

ENDWHILE 
This will allow the mouse to move a pointer 
on the screen for as long as the pointer 
position remains between the bounds set by 
x1 and x2, and y1 and y2. 


A good programmer will be conversant 
with all the methods in Basic by which a loop 
may be constructed, and be able to select 
the one which is most appropriate (most 
natural) in any given instance. 


BRANCHING 

The same should also be true when it 
comes to branching, at its simplest in the 
form of the IF-THEN statement. Again, this is 
a standard feature of all Basics, but if you 
are new to BBC Basic, then you need to 
familiarise yourself with its precise syntax in 
more complex examples. First of all, here is 
a simple instance of its use: 

IF option=1 THEN PROCmove_left 
lf the condition is true then execute the 
following statement(s) - a procedure call in 
the example. Several statements, separated 
by colons, can follow the THEN in which 
case all will be executed if the condition is 
true. Thus, for example: 

IF option=1 THEN PROCcalc: PROCredraw: 

count+=1: flag=TRUE 


If you look at other people’s programs 
you will find many instances where the 
keyword THEN has been omitted. This 
normally causes no problems in practice, 
and whether to include THEN or not is 
largely a matter of personal style. 


In the above examples no action occurs (or 
is specified) if the condition fails. This can be 
included using an ELSE clause, for example: 

IF option$="plus" THEN PROCincrease 

ELSE PROCdecrease 
The statements following the THEN or the 
ELSE can also include further IF-THEN or IF- 
THEN-ELSE statements, but it is often difficult 
to be sure of the logic of such constructions. 
Generally speaking, you should encounter few 
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problems with ELSE IF, but try to avoid THEN 
IF. In outline, you should find that: 
IF <condition> THEN <statements> ELSE 
IF condition THEN <statements> ELSE 
IF condition THEN <statements>. . 
will work as expected. 


Any problems that may occur can be 
avoided in Basic V by using a special block- 
structured |F-THEN. This takes the form: 

IF <condition> THEN 

<statements> 

ELSE 

<statements> 

ENDIF 
The ‘statements’ may include other IF- 
THEN-ELSE-ENDIF constructions, but no 
ambiguities will occur. 


Here is an example of the use of this form 
of IF laid out to show its structure (LISTO7 
will do this for you automatically). 

IF FNfin_record(n%) THEN 

PROCread_record(n%) 
PROCdisplay record(n%) 
IF FNupdate record(nt) THEN 
PROCinput_data 
PROCwrite record (n%) 
ENDIF 
ELSE 
PROCdisplay ("Record not found") 
ENDIF 


The coding attempts to locate and 
possibly update a record in a data file, using 
clearly named procedure or function calls to 
do all the detailed work. There is one main 
IF-THEN-ELSE-ENDIF with another IF- 
THEN-ENDIF nested inside. 


There is one important form of branching 
in Basic V which | have not covered this 
time, and that is the all-important CASE 
statement which handles multiple branching 
(although this can be achieved with nested 
IF-THEN-ELSE statements). This | hope to 
cover at some point in the future. 


In conclusion, if you are to make the most 
of BBC Basic then it is important to be 
familiar with all the possible forms of looping 
and branching. If some of these are new to 
you then | suggest you deliberately try to 
include them in the next program-which you 


write. 
47 


SILICON VISION 


SOFTWARE FOR THE ARCHIMEDES & BBC 


SolidCAD 


ARC-PCB 


i/timate 30 Draughting System for Architectural design. interior design, Engineering 
Design and Teaching COT. Allaws drawing in plan. front & side elevations and also directly 
n3D view. Includes powerful zoom & pan options for precision draughting and surface 
fetinition for creating solid colour objects. Also includes Sweep, Extrude & Macro 
for designing very complex objects easily. Designs created with SolidCAD are 
ompatble with the Realtime Graphics Lanquage for high-speed flicker-free animation 
The custom Archimedes version also performs smooth shading for realism 
sold CAD(Arc) users can upgrade to the Realtime Solids Modeller (Arc) for £40.00. 


£49.95 (ARC or BBC 8/B+/Master), 


hacilitie 


REALTIME SOLIDS MODELLER 


The package includes both the sophisticated design environment of SolidCAD and the 
high speed animation capability of a Realtime Graphics Language (RGL) module 
developed in pure ARM Rise code for supercharged performance. The package is ideal for 
Architectural design, Interior design, Engineering design & teaching CDT. The RGL 
module can be used to create standalone ftlicker-tree animation of designs from your own 
programs, Smooth shading is also performed for realistic images. Through our in-house 
expertise in 3D Design and High-speed techniques, no other package can rival the design 
environment & animation speed of the Realtime Solids Modeller 


£89.95 (ARC) 


REALTIME GRAPHICS LANGUAGE 


The Realtime Graphics Lanquage rom provides a complete 3D Solids’ Wireframe 
animation system with 52 star commands and 3D Editors for designing objects to animate 
fronyyour own programs, includes a 35,000 pixels‘ sec line generator tor fast 3D drawing 
rates, 3D Rotate, Scale, Orbit. Perspective and Turtlegraphics. Also compatible with 
designs created with SolidCAD (BBC) 


£49.95 (BBC B/B+/Master) 


SUPER-DUMP 


The ultimate printer driver which takes advantage of the highest resolution capability of 
ordinary Epson compatible printers to provide 1920 » 1024 resolution, Images can also be 
scaled, positianed and previewed before printing, Fully compatible with SolidCAD 
Realtime Graphics Lanquage, Gate-Array design system & 3D CAD! Animation system 
Your own graphics programs or other CAD packages can be mace compatible with Super 
Dump by the addition of a few simple commands. An example program is included inthe 
package 


£15.95 (BBC B/B + /Master), £24.95 (ARC) 


Presentation System 
The package provides an interactive environment to create, edit and play-back computer 
ontrolled presentations for lectures and demonstrations. Also handles graph plotting for 


al & user defined functions which can be incorporated within the 


pol 
pre 


£34.95 (BBC B/B+/Master), £49.95 (ARC) 


All Archimedes software run in native mode on A305 ~ A440 & A3000 with Arthur 1.2 or RISC OS 
SILICON VISION LTD, SIGNAL HOUSE, LYON ROAD, HARROW 
MIDDLESEX HA? 2AG. TEL: 01-422 2274 or 01-861 2173 

FAX: 01-427 5169. TELEX: 918266 SIGNAL G. 

BQN (Access/Mastercard/Eurocard accepted) 

All prices include VAT and Carriage (Overseas orders add £4). 


1S 


The ultimate PCB design system 
developed specifically tor the Archimedes 
with a specification that cannot be 
matched. Includes Automatic routing. 
Rats-nesting, 8 layers, Surface mount 
capability, 0.001 resolution, 32°» 32 
maximum board size, On-line Help, Fast 
Zoom/Pan/Redraw, Text & Silkscreen 
facility. Variable Line/Pad'Text/Grid sizes. 
Part Libraries, Block Move Copy!Rotate 
Mirror’/Erase options, and up to 300,000 
components 

For hardcopy. the system supports the 
industry standard HP-GL. GRAPHTEC. 
PLOTMATE plotters and printers at their 
highest resolutions, Also provides 
automatic drilling information with 
extensive support from PCB 
manutacturers for final layoutand 
production. optional | year telephone 
Hotline support (£100) and software 
maintenance service (£75) is also 
avaiable. 


£195.00 (ARC) 


Risc BAS/C 


The first true BASIC V syntax compiler 
which will convert your programs into 
supercharged Risc code for turbo 
performance leaving the competition 
standing, Features include Relocatable 
modules, tulicross references, Double 
precision Hoating point & Integer support 
in-line assembly, Window-based or 
command line compilation environment 
standalone code generator objectcode 
optimiser, fullarray manipulation and 
dimensions support, mulliple exit 
structures & full runtime error handler 


£99.95 (ARC) 


RiscFORTH 

Anew 32-bit implementation of the 
FORTH.-83 standard, designed to take full 
advantage of the ARM architecture. 
Features include Multi-tasking, 
Optimising compiler, built-in ARM 
assembler with floating point mnemonics, 
built-in Full screen Editor, File system 
interface, OS calls support, Floating point 
& integer maths, WIMP support, Single- 
step debugger, Shadow screen for 
documentation, Block manipulation. 
Dictionary & Vocabulary display, Call 
linding and a standalone code generator 


£99.95 (ARC) 


«Pav The RISC OS Programmer's Reference Manual 


David Spencer previews Acorn's definitive reference guide to RISC OS. 


Acorn has just released the final draft of the 
RISC OS Programmer's Reference Manual. 
The pre-release version we have has 
inconsistent page numbering and a lack of full 
indexes, but apart from that is identical to the 
final version which will be on sale shortly. 


The new PRM is a massive four volumes, 
each one being around 500 pages in length. 
This makes it over three times as long as the 
existing PRM. Rather than repeating the 
indexes four times, these have been separated 
into their own volume. As well as a con- 
ventional subject index, there are also indexes 
for star commands, OS Byte and OS Word 
calls, and SWls (both by number and name). 


CONTENT 


The manual is split into five major 
sections, plus a set of appendices and 
tables. The first section is referred to as an 
introduction, but is in fact much more than 
that. It is in this section that all the 
fundamentals of RISC OS are explained, 
including the basis of SWI calls, star 
commands, OS Byte and OS Word, 
interrupts, events, errors, buffers and 
vectors. Also in this section is a brief 
description of the Archimedes hardware. 


The second section covers the RISC OS 
kernel which consists of all the central 
features that are not dealt with separately. 
Among these are the VDU drivers, character 
input and output, relocatable modules and 
memory management. 


The third section is devoted entirely to the 
subject of filing systems. This handles the 
individual filing systems as well as the 
FileSwitch and FileCore modules which are 
central to all filing systems. The fourth 
section explains in detail the Window 
Manager, and therefore also includes the 
material relating to the writing of multi- 
tasking applications. The final section is 
entitled ‘System Extensions’, and deals with 
all the leftovers. For example, the Font 
Manager and sound system feature here. 


The appendices cover ARM assembler, 
the linker, file formats, and various topics 
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related to interfacing with compiled 
languages. The manual is rounded off with 
tables of VDU codes, screen modes, file 
types and character sets. 


Obviously with a manual that is three times 
the length of the existing PRM, you would 
expect it to contain much more material, and 
this is indeed the case. Much of this is totally 
new information that arises as a result of the 
new features of RISC OS. On the other hand, 
though, many areas which are largely 
unchanged from Arthur are now documented 
in greater detail, including sections on some 
previously uncovered subjects. For example, 
there is now a large chapter on Expansion 
Cards (Podules) which explains the basis of 
writing a podule as well as detailing the 
available commands. The existing PRM has 
just two pages on the subject. 


Another idiosyncrasy of the new PRM is 
the chapter on the Font Manager. Rather than 
documenting the Font Manager supplied with 
RISC OS, it instead deals with the new 
Outline Font Manager which is currently only 
available with the Acorn DTP package. 


STYLE AND PRESENTATION 

The new PRM is in the standard 2/3rd A4 
size adopted by Acorn, and each page has a 
line down the left margin, with sub-headings 
in the margin. This layout is very similar to 
that of the other RISC OS guides. The 
material content, and its layout, has been 
rationalised when compared with the original 
PRM. Each major section is split into a 
number of chapters, each of which covers an 
individual topic (for example character output 
or relocatable modules). 


Each chapter starts off with an 
introduction which lists what is covered in 
that chapter, followed by an overview which 
explains the principles of the particular RISC 
OS feature dealt with by that chapter. Next is 
a section of ‘technical details’, which covers 
the material in more detail. This is followed 
by the explanations of star commands, SWI 
calls etc, with an uncluttered one per page 
layout. Some chapters also contain 
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application notes to explain particular 
methods and techniques. 


One thing which I’m sure many peopie 
will find a little strange is that the new PRM 
is for RISC OS, while the old one was 
specifically for the Archimedes. This means 
that throughout the manual an abstract RISC 
OS based computer is referred to, rather 
than the Archimedes. Presumably this is so 
that the material is also of relevance to the 
R140 UNIX workstation. 


CONCLUSION 

The RISC OS PRM is one of those books 
that if you need it, you have to buy. There are 
no alternatives, and hence you have to live 
with any failings. Thankfully, though, | can say 
that there are few of these, and the PRM is a 
great improvement on the original, both in 
terms of content and presentation. However, it 
must be remembered that this is a reference 
work, and many people will find it hard going. 


| am sure that many people who have 
already bought the existing PRM are going to 
begrudge having to pay for another manual, 
especially when it will cost more than the 
actual RISC OS upgrade. All | can say is that 
this is the cost of progress, and if you want to 
use the new features of RISC OS then you 
will have to buy the new PRM. If you are not 
convinced, then you might like to consider 
that a similar set of manuals for the £400 
Atari ST will set you back around £200. 


People who have not already bought the 
existing PRM must decide whether they 
have a need for such a manual. As it stands, 
the Welcome Guide and User Guide 
supplied with RISC OS are very much aimed 
at the user rather than the programmer. 
Even the optional BBC Basic Guide only 
covers the Basic language, and not the 
operating system features. Therefore, if you 
want to do any serious programming (and by 
that | mean anything more than a few lines of 
Basic), then the RISC OS Programmer's 
Reference Manual is a must. 


The RISC OS Programmer's Reference 
Manual is due to be launched in the autumn 
at a price of around £79.00. RU] 
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Emerald Publishing 


An advanced user guide 
by 


Anne Rooney 


The advanced user guide helps you get the 
most from Acorn DTP. With full operating 
instructions, hints and tips, style guidelines, 
instructions on creating a wide varicty of 
documents, and on how to exploit its 
powerful features to the full, this book leads 
you through ownership of Acorn DTP from 
installation to becoming an expert user, It 
goes far beyond the official User Guide. 


Available now from Emerald Publishing, 
Dept R, PO Box 324, Cambridge CB1 3HB. 
£14.95; examples disk, £3.95, p&p included. 
Cheques payable to Emerald Publishing. 
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FORMATTER UPDATE 


By Glynn Clements 


Last month's Formatter program fails to 
report certain disc errors on the verify option. 
The following changes should be made to 
the listed program to correct this, but note 
that the magazine disc for July/August 
contains the updated version of this 
program. 


Add the line: 
1760 IF ((!errorp$ AND &FFFFFF)=&0108 
C7) AND (format$="E") AND (NOT verify’) 


THEN 
Delete line 1770. 


Add the line: 
1830 SYS "OS GenerateError",errorpt 


Finally, add the following lines: 


1231 SYS"ADFS DescribeDisc",STRS (driv 
e%),rect 

1232 IF rect!16=655360 THEN 

1233 format$="L" 


1234 ELSE 

1235 IF rec%?5=0 THEN format$="D" ELS 
E format$="E" 

1236 ENDIF 


Unfortunately, the problem was 
discovered too late to incorporate the 
necessary changes in the magazine version 


of this program. w 


Dynasties 
Chronological tables of major dynasties 
and rulers, from 3000 BC until the present. 
100k program for the Archimedes. 


Cheque/PO £18.50 payable 
P Ghiringhelli 


116 Sheep Walk, 
Shepperton, 
Middlesex TW17 OAN. 


ARCHIMEDES EXPANSION BOX 


eee 


Power Supply included. 


Fit more expansion cards to your system 


For the ACORN A300, A400 and A3000 series. 

Increase to 8 slots (max) for A300 / A400 and 6 slots for A3000. 
3 or 5 single and full width expansion cards can be fitted. 

Plugs to A series backplanes or A3000 expansion connector. 


Contact SGB Computer Services for prices and delivery. 


SGB COMPUTER SERVICES 


140 Disraeli Road, London SW15 2DX 
TEL: (01) 874 5675 


MACH 


ARCHIMEDES MEMORY UPGRADES 


Break the Megabyte barrier with Mach Technology's 2MB and 4MB expansion 
boards for 300 Series machines. 


2Mbyte — £340 
4Mbyte — £520 


HYPER BASE 


TTT OTT 


[isonet } a 
Sorat AM CTI TESLA COTTE TTT 


An advanced database architecture supports ‘cards’ and ‘stacks’ which can 
contain textual and graphical information in any combination. 


Cards may be connected via user defined links to allow arbitrary information 
networks to be constructed. 


Other features include powerful search and query functions across text fields, 
sorts and calculations, report generation and printing and the exchange of text 
and graphic images with other programs. 


£49.95 
MODULA-2 


The epitome of structured programming languages now available on the 
Archimedes. 


* Advanced development %* System library support for Risc 
environment Os, graphics, WIMP 
* Separate compilation * Extensive documentation 
* Rapid development cycle * Language tutorial 
£89.95 


MACH BASIC 


A true production quality compiler that supports the full BASIC V language. 
State-of-the-art parsing, analysis and code generation techniques combine to 
produce the fastest compiler around. 


£39.95 


TECHNOLOGY 


MACH-286 


Open the door to largest software base in the world with our fully IBM 
compatible co-processor. 
The Mach-286 features a full-speed Intel 80286, the MS-DOS operating 


system, standard graphics support, numeric co-processor facility, the Mach 
BIOS and more for only £299. 


HARD DISC SYSTEMS 
20Mb 65ms 


£249 
£289 


£339 


Compatible with A305-310, backplane required 


Software prices include VAT and delivery in the UK 
Hardware prices exclude VAT and carriage 


MACH TECHNOLOGY LTD 


29 Yarm Lane, Stockton, Cleveland TS18 3DT 
Tel: (0642) 613143 


Transferring Data Files Between Software Packages 


By Richard Kirby 


Transferring data between different 
software packages is a fundamental 
requirement, but unfortunately it is one that 
is overlooked by a great many software 
houses. For example see our review of 
Minerva's Ancestry in RISC User Volume 2 
Issue 8 where a special routine had to be 
written to import data. In an ideal world all 
packages would provide routines that allow 
data import and data export in commonly 
used formats. 


Comma Separated Value (CSV) format is 
probably the most common format for data 
transfer. In CSV format each piece of data is 
separated from the next by a comma. 


As an example let us examine the 
transfer of data from BEEBUG's own 
Masterfile package to Logistix. Masterfile has 
no CSV export facility, whereas Logistix has 
a CSV import facility. 


MASTERFILE TO LOGISTIX TRANSFER 
Logistix is one of the best integrated 
business software packages available for the 
Archimedes. It combines the elements of a 
spreadsheet, timesheet, database and 
graphics package. Its weakness, however, 
for Archimedes owners having upgraded 
from an older Acorn machine, is that their 
database information from BBC programs 
cannot be used directly in it. This is a great 
pity because Logistix is designed to 
manipulate database information in many 
varied ways. The program presented here 
takes files from the BEEBUG's Masterfile 
database and converts them to CSV format 
for loading into Logistix. They can be kept in 
the Logistix database permanently or, if 
preferred, transported from Masterfile simply 
to be manipulated in the spreadsheet, 
graphics and time sheet areas of Logistix. 


Masterfile’s data format is described in its 
manual, and can be found dynamically from 
the “Descriptor” file. In the program, the 
procedure PROCgetdescriptor reads the 
field and record characteristics. Matters are 
kept simple, as all Masterfile data is held as 
strings. You should be aware that Masterfile 
fields can contain commas and quotes within 
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them, and these must be removed (or in this 
case converted to a ‘\’) before conversion to 
CSV format. 


The program is relatively short and is 
very simple to use. Type it in, save it to disc 
and then run it in the normal way. The 
screen will clear and you will be prompted for 
the Masterfile data path. Simply press 
Return to accept the displayed default, 
otherwise enter the required pathname. After 
you have entered this information, you will 
be prompted to insert the Masterfile disc, 
and then conversion will commence. 


The transferred indicator on the screen 
shows the record number being transferred. 
When this is complete, the new file will then 
be copied into the Logistix directory of your 
Logistix disc, and a message appears, 
instructing you to boot up the Logistix disc 
and type the commands to load a new file. 
These commands are as follows: 


/L - to select load 

(e - to load a CSV format file 
<name> - the name of the database file 

R - load the file into rows 


The file will then load and the database will 
be displayed. When saving the database, the 
usual ‘Logistix’' format option can be used. 


HOW IT WORKS 

Logistix has an option to load CSV format 
files. The program given here makes the 
Comma, Carriage Return, and Line Feed 
insertions automatically. Because commas 
are used to separate fields, and quotes within 
strings would upset the format, any existing 
commas and quotes in the data are 
automatically changed to back-slash 
characters so that they do not upset the 
converted database format. If your 
requirement is for a different character, then 
alter the character to replace the comma and 
quote by amending the back-slash in line 680. 


Hopefully, you will find that the techniques 
used in the program can be extended to 
allow CSV files to be created from packages 
that do not have this facility. 
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10 REM >MFtoLGX 
20 REM Program Masterfile-Logistix 
30 REM Version A 1.04 
40 REM Author Richard Kirby 
50 REM RISC User September 1989 
60 REM Program Subject to Copyright 
70: 
80 MODE 12 
90 ON ERROR GOTO 960 
100 DIM fname$ (18) 
110 PRINT"MASTERFILE TO LOGISTIX CONVE 
RSION"' STRINGS (33, "=") 
120 vbU28,0,31,79,3 
130 REPEAT: name$=FNresponse ("Name of £ 
ile", "") :UNTIL name$>"" 
140 path$=FNresponse ("Masterfile path 
name",":0.$.MFdata") 
150 Ldrive$=FNresponse ("Data drive for 
Logistix CSV data","0") 
160 CLS:OFF:PRINT"Press space when Mas 
terfile disc ready" 
170 REPEAT UNTIL GET=32:CLS 
180 : 
190 PROCgetdescriptor 
200 m£=OPENUP (path$+".Masters."+name$) 
210 1lgx=OPENOUT (":"+Ldrive$+"."+"$.log 
istix."+name$) 
220 PROCwriteheadings 
230 : 
240 FOR rec=1 TO lastrect 
250 PTR#mf=rec*reclent+1 
260 PRINTTAB(0,0);"Transferred: "; INT ( 
(rec/lastrec) *100) ;"%" 
270 FOR f=1 TO fields 
280 INPUT#mf£, field$ 
290 PROCout (FNstrip(fieldS), f=fields*) 
300 NEXT f 
310 PROCcr 
320 NEXT rec 
330 CLOSE#0 
340 ON 
350 CLS 
360 PRINT"Now 'Boot' up logistix disc 
and type: /LC"+name$+"<return>R" 
370 PRINT"Then save the data in the no 
rmal fashion." 
380 VDU26:PRINT'''* 
390 END 
400 : 
410 DEFPROCgetdescriptor 
420 LOCAL x,f 
430 LOCAL ERROR 
440 X=OPENUP (path$+".Descriptor."+name 
$) 
450 
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INPUT#X, fieldst, lastrec% 
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Transferring Data Files Between Software Packages 


reclent=0 

FOR f=1 TO fields 
INPUT#X, ftype$, flen, fname$ (f) 
reclent=reclent+flen+2 

NEXT f£ 

CLOSE#X 

ON ERROR LOCAL *CDIR $.Logistix 
*DIR $.Logistix 

*DIR $ 

ENDPROC 

DEFFNst rip (f£$) 

LOCAL i:i=1 

WHILE MID$(f$,i,1)="_" AND i<LENE£$ 
it+=1:ENDWHILE 

=MID$ (£$,1i) 


DEFPROCout (T$, last) 

LOCAL c$,i 

FOR i=1 TO LENTS 

c$=MID$ (TS,i,1) 

REM Replace commas and quotes (CHR 


$34) in fields by \ character 


680 
690 
700 
710 
720 
730 
740 
750 


IF c$="," OR c$=CHR$34 c$="\" 
BPUT#1gx,ASCc$ 

NEXT 

IF NOT last BPUT#1lgx,ASC"," 
ENDPROC 

DEFFNresponse (q$,a$) 
PRINTCHRS12;q$;">";a$'''"<return> 


for no change." 


760 
770 
780 
790 
800 
810 
820 
830 
840 
850 
860 
870 
880 
890 
900 
910 
920 
930 
940 
950 
960 
970 
980 


OFF :G=GET: ON 

IF G=13 THEN =a$ 

REM Line 800 puts key pressed 
REM back into keyboard buffer 
SYS "OS Byte", 138,0,G 
PRINTTAB (LENg$+1, 0) ; SPC (80) 
INPUTTAB (LENg$, 0) ;">"oa$ 

IF oa$<>"" THEN a$=oa$ 

=a$ 

DEFPROCwriteheadings 

FOR f=1 TO fields% 

PROCout (fname$ (f) , f=fields%) 
NEXT: PROCcr 

ENDPROC 

DEFPROCcr 

BPUT#lgx, 13:BPUT#1gx, 10 
ENDPROC 

CLOSE#0: ON: VDU26 
PRINTTAB (0,15) ; :REPORT 
PRINT" @ line ";ERL 
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aan 
ARE YOU GOOD ENOUGH? 


As the leaders in software for the Archimedes range of computers, CLARES 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we are. 


If you have written any programs, completed or not, then we would like 
to hear from you. 


lf you Nave any ideas for programs and have the ability to execute the 
ideas then we want to hear from you. 


If you have the ability fo program the Archimedes but not the ideas to 
program then we want to hear from you. 


Programs can be written in any language as long as they perform their 
stated task, Many of our programs contain large chunks of BASIC with 
ARM code in the areas that it is needed. BASIC on the Archimedes is a 
very powerful language and we do not attach any snob value fo its use. If 
your program does what is meant to do then thats all we are interested in. 
Why not join the top team on the Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and invitations to 
our informal programmers seminars. 


The most important point is that you will be earning top royalty rates of if 
you prefer we will purchase your program outright. 


Please write, in confidence, to Mr. D. Clare at: 


Clares Micro Supplies, 
98 Middlewich Road, 
Northwich, 
CHESHIRE CW9 7DA 


lf you have a program either complete or in development then please 
enclose a copy for our evaluation. 


To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 


Act today and become part of the leading software team producing 
software for the worlds fastest micro. 


| as 
TECHNICAL QUERIES 


PRINTING PROBLEMS AND SPRITE SIZES 
Dear RISC User, 


In response to your request for ideas for 
articles and programs, can | suggest that you 
cover configuring the RISC OS printer drivers. | 
have a Hewlett-Packard Deskjet, but | am 
restricted to using it in Epson emulation mode 
because Acorn do not offer a printer driver for 
the Deskjet. 


Also, in the article ‘Creating RISC OS Application 
Directories’ in Volume 2 Issue 4, you state that 
the sprites used to represent files should be 68 by 
68 graphics units. | have discovered that this is 
much too big, with a size of 42 by 17 pixels being 
the maximum. 


Nobilangelo Ceramalus (New Zealand) 


A RISC OS printer driver is an application which 
provides a unified view of the printer to other 
pieces of software, This means that any RISC OS 
application can print its output using just a single 
print routine. It is up to the printer driver to interface 
this output to the actual printer. RISC OS is supplied 
with two printer drivers, one for Epson compatibles, 
and the other for PostScript laser printers. Both of 
these can be found on Applications disc 1. 
Unfortunately, each printer driver Is specially written 
for a particular printer, and it is not possible to re- 
configure them for other printers. However, it is 
possible that Acorn, or a third party, will bring out a 
driver for the HP DeskJet, and in the meantime, 
Acorn’s new DTP package contains a driver for the 
HP LaserJet, and this may work with your printer. 


On your second point, you seem to have confused 
the terminology. The article stated that the sprites 
should be defined to be 68 by 68 graphics units in 
mode 12. In this mode, there are two graphics 
units per pixel horizontally, and four vertically, 
Therefore, 68 by 68 graphics units corresponds to 
34 by 17 pixels. Hence, the height is as you have 
discovered, and the width that you hove 
suggested Is in fact too wide. 


David Spencer 
RISC User September 1989 


CHOOSING AN ARCHIMEDES 
Dear Sir, 


| joined RISC User because | intended to 
purchase oa 310. But just before | did, the new 
ranges were announced. Could you advise on 
the relative merits of the new machines in the 
middie of the price range. 


K.R.Chester 


If sounds as if you are thinking of buying o 410/1 
or 420/1. Of these two, | consider the 410/1 to 
be the best buy. The beauty of this machine is 
that It ls expandable right up to the spec of the 
440, It contains IMbyte of RAM, and you can 
add a further 1Mbyte to take it towards the 
spec of the 420/1, and then a further 2Mbytes 
to upgrade it to a full 4Mbytes. You may not feel 
that you need more than IMbyte of RAM at the 
moment, but when multi-tasking with RISC OS, 
lMbyte is really a bare minimum, and will be 
insufficient for certain applications such as 
desktop publishing. 


The 410 does not have a hard disc, but it has a full 
hard disc interface built in. This means that all you 
need Is a bare drive, and these are very 
reasonably priced. With the 420/1 you get 
2Mbytes of RAM and a 20Mbyte hard disc. But 
you can now purchase faster 40Mbyte drives for 
a similar price difference (taking the price of the 
RAM upgrade into account), 


So if you were thinking of buying a 400 series 
machine, | would recommend the 410. And if you 
need more RAM, then note that the RAM is 
definitely a dealer-only upgrade. The new RAM 
chips in the 400 series are mounted vertically, and 
their pins are very very easily bent. A hard drive, 
though Is much easier to fit (see the review 
elsewhere in this issue). 


Lee Calcraft 
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ROBICO ADVENTURES 


FOR THE ARCHIMEDES 


RISE IN CRIME (Archimedes 305/310/400 £29.95) 


In the vast, galaxy-wide federation, you are one of the abnormal few: unconditioned, discontented and insubordinate! Can you rid yourself of the 
shackles of this conformist, mind-imprisoned society? Rise in Crime boasts over 396K of text, 400 individually described locations, 150 objects and 
several high resolution colour graphic screens! Mouse driven input and an advanced parser make this a superb addition to your Archimedes collection! 


FUGITIVE’S QUEST (Archimedes 310/400 £29.95) 


As Paul Preston, respectable schoolmaster, your life is shattered when you are convicted of murder - acrime you did not commit! Set in 1952, against 
the stunning backdrop of southwest England, the hangman’s noose awaits unless you escape and find the evidence to clear your name! Fugitive’s 
Quest is a large adventure with about 230 locations, 80 objects and reams of well written text. An advanced parser, mouse driven input and several full 
colour, photo-quality illustrations complete the unmistakable feel of Robico quality. 


ENTHAR SEVEN (Archimedes 305/310/400 £29.95) 


It is the distant future . .. Whilst on board a tiny Interplanetary Space Hopper its orbit begins to decay! Once on the planet surface can you escape and 
return, again, to the freedom of the stars? Enthar Seven is a disk based mega-adventure! It has 450 locations, 80 objects, a massive vocabulary and 
1200 messages! And that’s just the 8-bit versions! The Archimedes version has over 140K of text and some of the best graphics you'll ever see! 


You can order by telephone using your ACCESS card, or by cutting out the coupon below. All orders are despatched first class by return. 


RISE IN CRIME 
FUGITIVE’S QUEST 
ENTHAR SEVEN 


| enclose a cheque/postal order payable to ‘ROBICO' for £ ...........0-2......0.0... Psa peaeete Signature 


or please debit my ACCESS account: AR) ak a a WA a Expiry Date 


= Postbag 


A TOUCH OF ALCHEMY 
| would like to point out an inaccuracy in Volume 2 Issue 7. 
You say that the ‘Archimedes Visuals’ is a carbon atom 
animation. You also state, correctly, that the animation 
shows 12 electrons moving round its nucleus. However, a 
carbon atom only has 6 electrons. Carbon has a total of 12 
nucleons (6 neutrons and 6 protons). As it has 6 protons 
and is not ionised (as it is an atom) it follows that it must 
also have 6 electrons. The element with 12 electrons, 
which the animation actually shows, is magnesium. 
David Miller 


Mr Miller was not the only RISC User member whose 
sharp eyes spotted this. Clearly our knowledge of 
chemistry (or is it physics) is not to the same standard as 
our computing. Our apologies for any contusion which 
this mis-labelling caused. 


A3000 A BUSINESS MACHINE? 

As a non-educational user, | am surprised and 
disappointed that in your June review (Volume 2 Issue 7) 
you dismiss the A3000 as not being a business machine. 
Surely, if a hard disc (or even a second floppy) can easily 
be added, why should it not be a full-blown business 
machine? Software firms considering supporting the 
A3000 for business applications will surely be put off by 
such attitudes. 


The line between home, business and even education 

uses for micros is narrowing fast. Retaining these artificial 

divisions is now becoming outdated and inappropriate. 
$.Morris 


| do not believe we ‘dismissed the A3000 as not a 
business machine’ but stated what | believe to be true, 
namely that Acom was targetting the A3000 towards the 
lower end of the educational market and to the home 
user, in competition with the Atari ST for example. That 
does not make it any the less of a business machine, but 
we would still recommend business users to go for a 
400/1 series machine, where a hard disc or second 
floppy can be mounted internally, and any machine in the 
range can be enhanced to 4MBytes of memory. 
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COPY PROTECTION 

| agree entirely with Simon Coulthurst (Postbag, RISC 
User Volume 2 Issue 7) regarding the form of copy 
protection used by Minerva. | use System Delta Plus, and 
have corresponded with Minerva about their policy on 
this, receiving the same unsatisfactory answer. 


Many people must be deterred from buying, or making full 
use of System Delta Plus because of the way copy 
protection is applied. First of all, the resultant disc 
swapping is very annoying, but more important are the 
issues concerned with long term security and the 
accessibility of one's data; what happens, for example, if 
Minerva should unfortunately cease to trade? And it goes 
against the grain to fork out another £25 for a spare disc, 
or £199 for a copyable version when one simply wishes to 
continue as a single user. 


One asks oneself what the value of a relatively weak 
method of copy protection can be. The accomplished 
‘hackers’ will have little difficulty in making copies. 
Hence the protection only prevents small-scale trading 
in copies, by those with less skill; the cost to Minerva in 
annoying the user, and in lost sales, must surely 
outweigh this? 

David Casey 


Copy protection is a subject that seems to arouse 
strong feelings in a number of users, and in some 
software houses as well. Clearly users, particularly 
those who make frequent use of some application and 
maybe depend upon it in some way, feel more 
vulnerable to possible corruption of software, and a 
greater need to have a full backup facility. Software 
houses are equally concerned about software piracy. 
The worid of microcomputers as a whole seems to be 
heading towards non-protected but maybe 
personalised software, which may in turn reflect a 
greater maturity by the computing community as a 
whole. If anyone (user or supplier) would like to argue 
for some form of copy protection then we would be 
pleased to consider their views for publication on this 


page. 
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HOLee Oued? 


ARCHIE POWER 
Holed Out really shows off the power 
of the Archimedes at its best. The 
game is completely mouse controlled 
and features atmospheric digitised 
sound effects to convince you that you 
are really playing gol. 

° 
Each of the 3 versions of Holed Out 
include an Instruction Manual which 
features easy to follow guidelines, 
general rules of golf and detailed scale 
maps of all their respective 
36 holes. 


— “ay 
~~ | GOLF GAME 


Peed EXTRA 
COURSES 


ARE NOW 
; gq AVAILABLE 


—$<$  _ "| play golf and this is the nearest thing 
j I've seen to the real game ona computer”, 


Archive June 1989 


Ba i 


2 NEW VOLUMES REVIEWS 


In response to your many requests we have now produced “In the June issue of the Micro User, Holed Out for the BBC Micro was 

2 volumes of extra courses. Each volume contains 2 described as a test of skill not to be missed. The same game has now been 
superbly designed brand new courses plus the original released for the Archimedes and it is quite a stunning piece of work, 

Holed Out main program; therefore you do not need the ranking with Zarch and Conqueror in quality.....The graphics are effective 
original Holed Out to play them. Each course has been me- and have amusing little touches lke the ripples when the ball hits the water 
ticulously created to test your golfing abilities to the limits 

The holes are very varied and even Nick Faldo would need great game.” THE MICRO USER August ‘89. 


to use all his skills to keep up his recent record. “Sound is definitely a feature of Holed Out. There are samples for all sorts 
of situations; hitting trees, splashing into water, dropping into the hole and 
Holed Out Extra Courses Volume 1 of course whacking the ball." ACORN USER August ‘89. 


Holed Out Extra Courses Volume 2 


F hh fF F HOW TO GET HOLED OUT ;-—=— 
Archimedes 3 1/2” Discs :- y “a 
HOLED OUT...cccoses meee cacsennt b “b 


e 
The extra courses are generally 
harder; narrower and smaller fairways, 
very “protective” bunkers, stronger 
winds, steeper slopes etc. etc. 
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HOLED OUT EXTRA COURSES 1....16.65 


HOLED OUT EXTRA COURSES 2....16.65 ‘ 
All versions are available from most good dealers. 


Our dosha ware is second to nore. Send a the Fearth Dieeaciee 
j \| cheque, . or Access/Visa details. All copies 
Sent with all orders!! are sent the SAME day by 1st Class Post. 
; Telephone orders with Access/Visa are also welcome. —_ 
Includes details of ARCADE 24 Hour Answering Service, 7 days a week. — 
SOCCER, WHITE MAGIC ‘T? (0742) 700661 o 


1 & 2 & lots more!! The Fourth Dimension, P.O. Box 4444, Sheffield. 


DE/MOP Hint’ 


Rounded up by Lee Caicraft 


CONFIGURING THE DESKTOP 

To make your machine start up in the Desktop, type: 
*Configure Language 3 

and press Ctrl-Break. To make it start up in Basic, type: 
*Configure Language 4 

and press Ctrl-Break. 


DESKTOP KEYS 
The following summary of the effects of various keys and 
mouse buttons may prove useful 


Function Key 12 
F12 Star command 
Ctrl-Shift-F12 Quit the Desktop 


The Shift Key 

Holding down the Shift key has the following effects: 

1, Double-clicking on an application will open the 
application directory rather than running it. 

2. Dragging a file or directory to copy it to another 
directory alters the operation to a move, with deletion of 
the source(s). 


The Adjust Button 

Using the Adjust button rather than Select has the 
following effects: 

1. Scroll in the opposite direction on scroll bars etc. 

2. Single-clicking will mark an object without un-marking 
previously marked objects. 

3, Double-clicking on a directory opens or runs it as 
normal, but it also closes the parent directory. 

4. Clicking on a Filer Quit icon closes the directory but 
also opens the parent. 

5. Dragging a file or directory to copy it to another 
directory causes the source directory to be closed after 
the copy has been carried out. 


DRAGGING OBJECTS 

To simultaneously drag a number of objects for copying or 
whatever, mark each in turn using the Adjust button, then 
drag with Select (or with Adjust if you want to close the 
source directory). 


When dragging objects to an icon or directory, the tip of the 
pointer determines the destination of the drag, regardless of 
the size or position of the accompanying drag box. 
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COPY WARNING 

When copying objects by dragging them from one 
directory to another on the Desktop, the setting of the 
variable Copy$Options will determine how the copy takes 
place. By default it is not set up for forced overwriting of 
objects. Consequently, if there is already an object in the 
destination directory with the same name as that to be 
copied, the copy will not take place. When this occurs, no 
message is given, and the result can be that you fail to 
back-up a particular file. It is very easy to fall into this trap 
if you are copying a number of files at once, or if you have 
a hard drive. In either case, whether a particular file has 
copied over would not be obvious. 


To rectify the problem, use: 

*SHOW Copy$Options 
If a *~" character appears immediately before the “Fin 
the display, then forced overwriting is not set. To rectify 
this, use for example: 

*Set Copy$Options ~C ~D F ~P ~QRV 
using the response to “Show as a guide to the state of the 
other options. See the RISC OS User Guide for further 
details. 


AUTOMATIC START-UP 
To enter the Desktop and automatically run or install an 
application, type: 

*Desktop <name> 
where <name> is the name of the application, as 
referenced from a named disc. For example: 

*Desktop ADFS::RU207v1_00.$.!NotePad 
will enter the Desktop and place the RISC User NotePad icon 
on the icon bar, ready for immediate use - always assuming 
that RISC User magazine disc Volume 2 Issue 7 (with disc 
name “RU207v1_00") is in your disc drive at the time. 


To go one step further, and run |NotePad with the 
NotePad file Notes loaded, use: 
*Desktop ADFS::RU207v1_00.$.!NotePad Notes 


Unfortunately you cannot use these tricks with applications 
such as ArcDraw which need resources from the 'System 
directory, since the Filer will not have seen the resource 
directory before an attempt is made to run the application. 
In such cases you will need to adopt the technique 
described in RISC User Volume 2 Issue 7 page 33. 
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David Spencer rounds up another collection of hints and fips. 


BASIC TEXT SAVE (for non-Twin users) 

The operating system alias given below allows a text 
version of a Basic program to be saved directly, simply by 
typing TWIN. This works because when you execute 
TWIN (or TWINO) from Basic, the current program is 
detokenised, and the command ‘TWIN executed with 
parameters indicating where the text version of the 
program is stored. The alias picks up the TWIN 
command, strips out the addresses and saves the text file 
with the name ‘TextProg’. The “BASIC is necessary 
because Basic doesn't expect the “TWIN command to 
return. Incidentally, don’t add any spaces to the alias 
when entering it, as it will then be too long when the 
operating system expands it. 


*Set Alias$Twin SetEval xl ("%*0"RIGHT(LEN 
"$*0"=-1)) LEFT8|MSetEval x2 "%*0"RIGHT(LEN” 
%*0"-10))LEFT8|MSet Alias$x Save TextProg 
I<xl> |<x2>||MSetType TextProg Text] |MBasi 
c @|<xl>, |<x2>|Mx 


To revert the TWIN command to its real function, use: 
*UNSET Alias$Twin 


To load a text file back into Basic, the corresponding 
command to use is: 
*BASIC -load <filename> 


Thanks to Roger Wilson of Acorn for this idea. 


PRINTER PROBLEM 

When using certain early Archimedes with particular 
printers, occasional characters can be lost. This is 
particularly apparent when performing screen dumps on 
an Integrex 132 colour printer, causing blank lines to 
appear. This symptom is caused by a minor hardware 
problem with the computer, and it can be corrected by 
taking the machine to an Acorn dealer and asking them to 
perform Acorn field change order 2002, which they should 
do free of charge. 


GET THE LINGO RIGHT 

Do you know how to pronounce RISC OS? According to 
Acorn it should be Risk Oh Ess, and not anything else 
you might think of. And while they are about it, gone are 
gfaphics and text windows. Instead, these are now called 
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Viewports - presumably to avoid confusion with WIMP 
windows. And just to round things off, the beloved Podule 
has been wiped off the surface of the earth. From now on, 
things that plug into the backplane are to be referred to as 
plain boring expansion cards. |s the name Archimedes 
safe we ask? 


DEFECTIVE DISCS 
With the new E format discs offered by RISC OS, it is no 
longer necessary in most cases to throw away, or even 
reformat, a disc which develops a defective sector. 
Instead, the defect can be mapped out by using the 
command *DEFECT. This takes two parameters, the first 
being the drive number or name, and the second the disc 
address of the defect in hex. For example: 

*DEFECT :0 24800 
The easiest way to find out this address is to use 
“VERIFY which will report the disc address of each 
defect. 


If the specified defect is on an unused portion of the disc, 
then it will be mapped out. On the other hand, if the defect 
lies within a file, then the name of that file is printed. It is 
then up to you to delete the file if you wish, and issue the 
*DEFECT command again. If the defect lies in the disc 
allocation map, then you will get the message ‘Can't map 
out defect’, and the disc will have to be reformatted. 


PSEUDO FILING SYSTEMS 
Under RISC OS (and indeed Arthur), it is possible to 
direct any star command to a particular module. The two 
main uses of this are for executing a command on one 
filing system while another is selected, and for resolving 
problems when two modules use the same command 
name (for example “MEMORY is in both the debugger 
and Clares Toolkit Plus). To do this, prefix the command 
with the module name thus: 

*Adfs:Info * of 

*“Debugger:Memory 10000 


SILENT NETWORK 

By default, RISC OS pops up the hourglass when 

performing lengthy operations on an Econet Network. If 

for any reason you want to stop this, simply execute: 
*RMKILL NetStatus 
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ARM CODE SINGLE STEPPER A module which allows any ARM machine code program to be executed one instruction al a 
time, The register and memory contents can be read and altered between each instruction, The disc contains the tully 
commented source code for the module. 


RISC USER DESKTOP DIARY 
The first half of this handy RISC OS Desktop application. 


A POP-UP FILE SELECTOR (disc only) 
A user-friendly procedure which allows you to step through 
directories and choose files using the mouse. This routine can 
easily be incorporated into your own programs. 


ARCHIMEDES VISUALS: INBETWEENING 
A simple, yet flexible, program to illustrate how the 
Archimedes can be put to good use in animation. 


MASTERING THE WIMP 
This program from the first part of our major new tutorial series 
shows how to get a Wimp based multi-tasking program up and 
running. 


TRANSFERRING DATA FILES BETWEEN SOFTWARE PACKAGES = 
A program to convert files created using BEEBUG's Masterfile 
to Logistix format. 


ke STICKY DESKTOP 
A handy RISC OS Desktop utility which allows files and 
BONUS ITEMS *k directories to be dragged out of Directory Viewers, and stuck to 
the Desktop for use at any time. 
DIGITISED SCREEN A sample of the results that can be produced using the digitiser feature of the Brainsoft multi-lO podule. 
ATELIER SCREENS Some sample screens produced using Atelier from Minerva, reviewed in this issue. 
ACORN DIP SCREENS Some examples of Acorn's new DTP package in use. 
ARCSCAN DATA Index entries for this issue of RISC User and the latest BEEBUG (Vol.8 No.3) to be used with Arcscan. 
RISC User magazine discs are available to order, or by subscription. Full details of prices etc. are given on the back cover of each issue of RISC User, 


ARCHIMEDES SOFTWARE 


EMACS. Super editor with language. Now includes full C source code. 
MicroSpell. 43,000 word real time spelling checker module. 
XLISP. Object oriented version of LISP with C source and programs. 
C Toolkit. 20+ progs for C programmers. With C sources. grep, awk.... 
Kermit. Archimedes, BBC and MSDOS versions of file transfer prog. 
WIMP Chess. Good Wimp based chess game with many features. 
CrossStar. Wimp based crossword solver with huge dictionary. 
More C Tools. yacc and lex with examples and C source. diff, ctags. 
Little SmaliTalk. Original object oriented language with C source etc. 
GNU Tools#1. High quality tools with C source. egrep, sed, awk and diff. 
Clip Art#1. Over 50 pictures to paste into DTP/ArcDraw/Impression files. 
Disc Spark. Super RISC OS WIMP based multitasking file/directory archiver. 
Also !Backdrop sticky desktop, pd progs., and 1Mbyte colour pictures. 
Disc U-Tools. tar, compress, less, sort & indent with C sources. Use to swop 
files with UNIX. Indent is a very good UNIX C source code formatter, 
Disc MTV Raytracer. Database driven 3D renderiser with full C source. 
Produces pretty three dimensional ray traced pictures. 


Each disc is £5.99 inc. Buy four claim another one free! 
David Pilling, P.O. Box 22, Thornton Cleveleys, Blackpool. FY5 1LR. 


Free Air Mail delivery on overseas orders. More details available on request. 
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MEMBERSHIP 


\ RISC User is available only on subscription at the rates shown below. Full subscribers to RISC User may also take out 
a reduced rate subscription to BEEBUG (the magazine for the BBC micro and Master series). E 


All subscriptions, inckiding RISC USER SUBSCRIPTION RATES RISC USER 


overseas, should be in 
pounds sterling. We will & BEEBUG 
also accept payment by £14.50 1 year (10 issues) UK, BFPO, Ch.| £23.00 
Connect, Access and £20.00 Rest of Europe & Elre £33.00 / 
Visa, and official UK £25.00 Middle East £40.00 
orders are welcome. £27.00 Americas & Africa £44.00 
£29.00 Elsewhere £48.00 Fi 


BACK ISSUES 


\ We intend to maintain stocks of back issues New subscribers can therefore obtain earlier copies to provide a 
complete set from Vol.1 Issue 1. Back issues cost £1.20 each. You should also include postage as shown: 


First Issue 


Destination UK, BFPO, Ch.ls Europe plus Eire Elsewhere 
60p $1 £2 \ 
Each subsequent Issue 30p 50p £1 


‘may, SD VETS, al 


MAGAZINE DISC 


The programs from each issue of RISC User are available on a monthly 3.5" disc. This will be available to order, or 
you may take out a subscription to ensure that the disc arrives at the same time as the magazine. The first issue (with 
six programs and animated graphics demo) is at the special low price of £3.75. The disc for each issue contains all the 
programs from the magazine, together with a number of additional items by way of demonstraton, all at the standard 
rate of £4.75. 


A Disc subscriptions include postage, but 
you should add 60p per disc for 
MAGAZINE DISC PRICES UK Overseas Individual orders (0p for additonal 
Single Issue discs £475 £4.75 discs on the same order). 
Six months subscription £25.50 £30.00 ‘ 
Twelve months subscription £50.00 £56.00 


All orders, subscriptions and other 
correspondence should be 
addressed to: 


RISC User, 117 Hatfield Road, St Albans, Herts AL! 4JS. 
Telephone: St Albans (0727) 40303 
(24hrs answerphone service for payment by Connect, Access or Visa card) 


